** NOTE: This readme file contains instructions related to use of this component in Joomla 2.5.  Version 1.5 or 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.


/// 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_8_18_J25.zip

This is the component install file.  In the Joomla admin, go to Extensions -> Extension Manager -> Install.  If you already have a previous version installed, you do NOT need to uninstall it first.  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 & Install".  You should see a successful installation message.  For further assistance, see our video tutorial for Installation.


/// UPGRADING FROM DT REGISTER 2.7.8 or later (already in Joomla 1.6/1.7/2.5) ///

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. Install the new version of DT Register for Joomla 1.6/1.7/2.5. You DO NOT have to uninstall the previous version first. Your records, events, configuration, etc will NOT be removed. Files are replaced but all data is left alone. This is actually the case whether you uninstall/reinstall, or if you simply install over top of the previous version. Just make sure you use the Joomla installer and NOT just manually replace files.
4. IF you have changes in any CSS file or images, you can re-apply them to the new package installation. You can reload your backed up file, but you should always double-check to see if any changes were made in the updated version. You don't want to wipe out needed changes that may have been applied.
5. 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 are always found at the bottom of the new language files.
6. There are new Permission items you need to set. Go first to Permissions and check the boxes for "Manage Records", "Manage Locations" and "Manage Pay Options" for Super Users and anyone else that needs access. Make sure Super Users do NOT have the first box "Edit Own Items Only" checked.
7. There are new changes to Pay Options, giving the ability to as an owner to a set of pay options. Only the owner can use and edit a given set of pay options if they have permission for "edit own items only". You can also set the pay options as "Global" meaning anyone can use them, but not edit them. After this update, open each Pay Option setup and select an owner and set appropriate setups as Global. Save each one.
8. The same changes as made to Pay Options with ownership has also been done to Locations, so do the same updating to your locations. Also, locations now have a latitude and longitude setting. As you open, edit and save your existing locations, the latitude and longitude will be calculated and saved. You'll need to make sure this is done for the zip code radius search feature to work.
9. Now, you need to go to the DT Register Configuration, set all new parameters and SAVE. You should be all set now!


/// ADDITIONAL UPGRADE TASKS ///

- If upgrading from a version prior to 2.8.13, you'll need to open and re-save DT Register Permissions.

- If upgrading from a version prior to 2.8.12, you'll need to open and re-save any event that uses conditional fields. There is a new toggle on the fields tab within an event edit page that allows conditional fields to now be shown (and controlled) per event! So make sure each conditional field is enabled for the event as needed, then re-save. Changes were also included to the main.css file for this release so be sure to use the current CSS file.

- If upgrading from a version prior to 2.8.9, you'll find the Configuration area (on event listing tab) now has a Primary Ordering and Secondary Ordering. A hard-coded primary ordering by category is no longer forced. Set ordering as desired and re-save configuration. Also, if you do not re-save configuration, your date formatting will not look right due to date config changes in this release.

- If upgrading from a version prior to 2.8.7, you'll need to open and re-save all DT Register categories. Make sure the access level is set appropriately... and note that the Joomla access level "Guest" is NOT the same as "Public".


/// 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.


/// MIGRATING FROM JOOMLA 1.5 ///

If you are migrating from Joomla 1.5 to 2.5/3.x, you must first make sure you have upgraded DT Register in 1.5 to the latest version for 1.5. BACKUP ALL FILES AND DATA first before you do anything!!! If you migrate to 2.5/3.1 with an older version of DT Register in place, you WILL have issues. Be aware that you do not UPGRADE to 2.5/3.x, you MIGRATE... meaning you build a separate site, then move your 1.5 data into the newly setup site.

Follow these steps exactly:
1. Upgrade DT Register to the latest version within Joomla 1.5.
2. Export all DT Register database tables from your 1.5 site database. These tables will all begin with "jos_dtregister". Your site may use a different prefix than "jos_" so be aware of that.
3. Setup your 2.5/3.x Joomla site and run a migration tool to pull in all Joomla users, articles, and other core Joomla items from the 1.5 site. There are many tutorials you can find with a quick Google search for this. One good one is:
http://www.ostraining.com/blog/joomla/migrating-from-joomla-15-to-joomla-17/
4. Once the 2.5/3.x site is ready with core data, go to the new database and import your 1.5 data for DT Register that you previously exported. As your new database probably has a new database prefix, you'll need to make that change to your imported DT Register database tables.
5. NOW, install the DT Register component using the 2.5/3.x version. This will load the files and make any necessary updates to your data. All of your previous configuration, events, records, etc will be there.
6. Go to DT Register Permissions. FIRST, click "Sync Groups". This will sync your Joomla User Groups with the DT Register Permissions matrix. Then set permissions as desired.
7. Open each of your DT Register categories, set the access level and re-save them.
8. Open each of your Pay Options, set an owner and global status where desired and re-save each of them.
9. Open Configuration, set any parameters as desired that you did not already have in 1.5. Save.
10. Install and enable all of the DT Register plugins and modules that you NEED. See the readme file in the package for explanations of each one. Do not just blindly install them all. Determine what you need and load those items.

There are many CSS changes from 1.5 so be sure to use the new files and update them as needed. The language files are completely reformatted from 1.5 to 2.5/3.x so you can NOT use your old language files. You'll have to re-apply changes to the new files.

If you need to upgrade your 1.5 site to current version prior to the big migration, see the Joomla 1.5 folder of the DT Register package. You'll find the install package and a separate read me.txt file that gives detailed upgrade instructions.


/// 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 2.0.x or later. 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. 


/// 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_17.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, to the assigned "Details Article" or directly to registration forms. You can also choose to include data from the event such as category, location and price. 

- mod_dt_calendar2_5_5.zip

This is a module that shows the optional Mini Calendar. It can be set to link to events on a selected date in either a list or calendar view.

- mod_dt_cart2_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_8.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 as well as with a zip code radius search.

- plg_dteventlink2_8_0_J25.zip

This is a Plugin that serves a two-fold purpose. One, it enables you to add a "Register Now!" link in an article 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. Also, when syncing with JEvents, this plugin will add a Register button in the calendar details view. See our forum for a sticky post giving more detailed instructions for this plugin.

- plg_dtregister_ssl1_6.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_6.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.

- cbplug_dtregister_records1_6.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.4.x or later.
To install it, go to Components -> Community Builder -> Plugins

- plg_jomsocial_dtreg_records1_9.zip

This is a JomSocial 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.8 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_6.zip

This is a JomSocial 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.8 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!!

- dtregister_falang.zip

This is a package of five Falang 1.1.x content element xml files. If you are using Falang in a multi-language website, then you will want to load this package. Go to the Falang 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 details, custom fields and location names.  If you do not use Falang, then ignore this file... you won't need it. It does NOT install as a Joomla extension.

- Other Languages

Currently, frontend and backend translations are available for: English, Dutch, French, German and Portuguese. Then there are translations available for frontend only: 
Arabic, Czech, Dutch, English, Finnish, French, German, Italian, Portuguese, 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