** NOTE: This readme file contains instructions related to use of this component in Joomla 1.5. Version 1.6/1.7/2.5/3.x instructions are in a separate file. Thanks for purchasing DT Register! You are about to experience the best event registration solution for Joomla! We have put together some basic info here that should help you to know what to do with the items you just downloaded. For more detailed assistance, see our video tutorials in the support area of our website. NOTE: As of Nov. 1, 2013, we have discontinued tech support for Joomla 1.5 websites. We had already long stopped developing our extensions for 1.5 in regards to adding new features and improvements. We recommend that you migrate your Joomla website to 2.5 or newer as soon as possible. /// COMPONENT INSTALLATION /// This package contains multiple files for installing various elements of this registration solution. To install the DT Register component, locate this file in the group of extracted files that you unzipped from your download package: com_dtregister2_7_26a_J15.zip This is the component install file. In the Joomla admin, go to Extensions -> Install/Uninstall. If you already have a previous version installed, you will need to first uninstall that version. See upgrade instructions below. Otherwise, simply install this package by clicking the "Browse" button to locate the install file on your computer. After locating it, click "Upload File & Install". You should see a successful installation message. For further assistance, see our video tutorial for Installation. /// HAVING INSTALLATION PROBLEMS?? /// Some users experience installation problems due to more restrictive server settings. If you are having no luck getting the install to work, the first thing to check is your PHP setting for upload_max_filesize. This must be larger than 2M as DT Register is a larger package than the average extension. You can check this in the System Info area of Joomla. If for some reason you are unable to get this setting increased, you can use the Upload From Directory option. /// CAN'T SAVE CONFIGURATION?? /// If you are having problems saving the main DT Register configuration, it's because something is missing that is required. Check the Emails tab (which is probably bright red) and make sure "From Name" and "From Email" are configured. /// UPGRADING FROM DT REGISTER 2.7.0 or later /// 1. Backup your files and database just in case you experience any problems during or after the upgrade. 2. Download a copy of any CSS files, modified images, and the two language files IF you have made any changes to any of these files. If you haven't made changes, skip this step. 3. Uninstall the current version of DT Register. Your records, events, configuration, etc will NOT be removed. Files are replaced but all data is left alone. 4. Install the new version of DT Register for Joomla 1.5.x. 5. IF you have changes in any CSS file or images, you can reload them to your new installation as there are no changes to these items at this time. 6. IF you have changes in your language files, DO NOT reload them to your new installation. There will be new language items that you will need. You will find two language files for DT Register... one for the frontend and one for the backend (administrator area). These files are located at: /language/en-GB/en-GB.com_dtregister.ini /administrator/language/en-GB/en-GB.com_dtregister.ini If you have previously made any changes to your DT Register language files, you will need to re-apply them to these new files or just add the new language items which will be found at the bottom of the new language files. 7. After completing the upgrade, you need to go to the DT Register Configuration, set all new parameters and SAVE. You should be all set now! /// UPGRADING FROM DT REGISTER 2.6.9 or OLDER /// 1. Make sure you have first upgraded to version 2.6.8 or 2.6.9 of DT Register before you upgrade to 2.7!! This is very important! The 2.6.9 component installation file is included inside of the 2.7 package, if you need it. Follow the upgrade instructions in that file to upgrade. THEN come back here and continue to upgrade to 2.7. 2. Backup your files and database just in case you experience any problems during or after the upgrade. 3. Download a copy of main.css and the two language files IF you have made any changes to any of these files. 4. Uninstall the current version of DT Register. Your records, events, configuration, etc will NOT be removed. Files are replaced but all data is left alone. 5. Install the new version of DT Register for Joomla 1.5.x. 6. IF you have changes in your main.css file, DO NOT reload this file to your new installation as there may be new items in this file. You can however copy and paste in anything needed from your backed up file. This file is located at /components/com_dtregister/assets/css/main.css 7. IF you have changes in your language files, DO NOT reload them to your new installation. There will be new language items that you will need. You will find two language files for DT Register... one for the frontend and one for the backend (administrator area). These files are located at: /language/en-GB/en-GB.com_dtregister.ini /administrator/language/en-GB/en-GB.com_dtregister.ini If you have previously made any changes to your DT Register language files, you will need to re-apply them to these new files. 8. BEFORE YOU MODIFY ANY EVENTS OR RECORDS, Go into the new DT Register control panel on the backend and find the "Migrate 2.6 Records" button. Click that and read instructions on the next page. Click the large migrate button there and this will make sure all of your events and records are updated into 2.7 with all of the old data from 2.6. 9. After completing the upgrade, you need to go to the DT Register Configuration, set all new parameters and SAVE. If you have any issues after upgrading, you should also open all fields and re-save just to make sure that everything was migrated correctly. 10. Open and re-save all current events and all of your fields. Do not just assume that your fields will be displayed as they were before. Lots of changes have been made, so re-save events and fields to make sure everything is set the way you need it. 11. In the backend, go to Categories and make sure all of your categories are Published. 12. Don't forget to Uninstall/Reinstall all DT Register modules and plugins as they have all been updated for 2.7. 13. Now go and watch the new DT Register 2.7 video tutorials and get familiar with the new changes! These are located at http://www.youtube.com/dthdevelopment. The DT Reg control panel contains a link to these videos as well as the PDF Support Manual. /// OPTIONAL JEVENTS SYNC INFO /// The JEvents calendar component is NOT required for DT Register usage. There is an optional sync between DT Register and JEvents. To use this, you must have JEvents 1.5.x. See our videos for more info. Again, this is OPTIONAL. If you want to remove the sync between JEvents and your existing events, go to the DT Register control panel and click the "Remove JEvents Sync" button. DO NOT run this unsync script until you have verified that all of your migrated events and records are there and correct. /// PAYPAL INSTRUCTIONS /// If you are using PayPal payments, you must have Instant Payment Notification (IPN) enabled in your PayPal account for registration records to be created properly in DT Register. To do this, login to your PayPal account and go to Edit Profile. Under the "Selling Preferences" column, click on "Instant Payment Notification Preferences". The next screen will show if this is On or Off. To turn it On, click the EDIT button. Then check the checkbox and then input a url in the Notification URL box. DT Register actually has the necessary URL coded in, so it doesn't matter what url is input here. If nothing is there, just type in your website URL including the http:// on the front. Click SAVE and you're all set! ================================================= ADDITIONAL ITEMS - mod_dt_upcoming_event2_9_8.zip This is a module that shows the upcoming X number of events that are setup in DT Register for registration. You can configure this to link to JEvents details or directly to registration forms. You can also choose to include data from the event such as category, location and price. - mod_dt_cart1_5_3.zip This is a module that shows the optional DT Cart. If you are using multiple event registration (cart system), then you should install and enable this module. Otherwise, you don't need it. - mod_dtsearch1_5_0.zip This is a module that gives an advanced search for your events within a module position. You can filter your search results by category, location and/or moderator. - plug_dtregister2_7_7_J15.zip This is a Plugin that serves a two-fold purpose. One, it enables you to add a "Register Now!" link in a content item or wherever else you would like. By inserting a tag in the format {dtregister}event_id{/dtregister} it will embed the link to the event's registration forms. Two, if you set your event to include a details link, you can associate a content article with the event for showing further details. This plugin will automatically add the registration link at the bottom of the article. In both cases, the link can be configured to be an image or text link. - plg_dtregister_ssl1_5_1.zip This plugin is optional. If you install and enable this plugin, all DT Register links will be secure using a https. Then when you leave DT Register and go to any other part of your site, it will return to a non-secure http link, unless you specify in the parameters other components to ignore so their own SSL settings will be applied. - plg_jeventupdate1_5.zip This is a plugin that should only be installed if you are running JEvents and syncing DT Register and JEvents together still. After installing the plugin, be sure to enable it. There are no parameters to set. The purpose of this plugin is when you update the event title, date or time in JEvents, it will update the synced event in DT Register. - dtregister_joomfish2_1_7.zip This is a package of five JoomFish 2.1.x content element xml files. If you are using JoomFish in a multi-language website, then you will want to load this package. Go to the Joomfish Content Elements area in the backend, click Install, then load this zip file. It will install all five content elements, which will allow you to translate all configuration messages, category names, event messages, custom fields and location names. If you do not use JoomFish, then ignore this file... you won't need it. - cbplug_dtregister_records1_2_4.zip This is a Community Builder plugin, NOT a Joomla plugin. It adds a profile tab showing the registration history of a user. This version of the plugin is for CB 1.2.x. To install it, go to Components -> Community Builder -> Plugins - plg_jomsocial_dtreg_records1_5.zip This is a JomSocial 1.8 (or later) plugin and is optional. It should only be installed if you have the JomSocial component in use on your site. It adds a profile tab showing the registration history of a user. This version of the plugin is for JomSocial 1.6 or later. Install this plugin in the regular Joomla installation area. Don't forget to ENABLE it after you install. There are also some parameters to be set in the plugin. DO NOT INSTALL THIS PLUGIN IF YOU ARE NOT USING JOMSOCIAL!! - plg_jomsocial_dtreg_activity1_3.zip This is a JomSocial 1.8 plugin and is optional. It should only be installed if you have the JomSocial component in use on your site. It adds all registration actions to the JomSocial activity feed, similar to Facebook status messages. This version of the plugin is for JomSocial 1.6 or later. Install this plugin in the regular Joomla installation area. Don't forget to ENABLE it after you install. There are no parameters to be set in the plugin. DO NOT INSTALL THIS PLUGIN IF YOU ARE NOT USING JOMSOCIAL!! - Other Languages Currently, frontend and backend translations are available for: English, Dutch, French and German. Then there are translations available for frontend only: Arabic, Czech, Dutch, English, Finnish, French, German, Italian, Spanish, Swedish. For any of these language directories that exist in your Joomla installation, the corresponding DT Register language file will automatically be loaded when you install the component. More translations are always being added. - Image Source Files (image_sources.zip) DT Register has 8 different color packages for the various buttons and icons used on the frontend. Here in this unzipped DT Register package you will find a zip file image_sources.zip. If you want to change the text for these buttons, unzip this file and you will find a blank PNG button image of each size and color. Put your own text on these images, save your new image using the exact filenames used in the component, then manually upload over top of the original images at: /components/com_dtregister/assets/images/ =================================================== For instructions on using any of these DT Register add-on items, please see the DT Register area of our forum as well as our support manual and video tutorials. Thank you for your purchase! DTH Development