Ccnewsletter Manual

ccNewsletter 1.0.3 Manual v1.1 We have started the ccNewsletter manual, but as you can see its not that extensive yet. Please bear with us, we will try making it more complete in the future. In this • • • • •

manual you will find guides to: Installation Configuration Adding other languages Translating to new languages Integration with Virtuemart 1.1

About ccNewsletter If you want to know more about ccNewsletter check out our website or the listing on the Joomla! Extensions Directory: ccNewsletter on http://extensions.chillcreations.com ccNewsletter on http://extensions.joomla.org

Want a custom extension, a template, Dutch hosting or Dutch Joomla! Education? Check out Chill Creations! Extensions We develop high quality Joomla! extensions and can do custom work for you to! We have a lot of experience and work fast and secure. ccNewsletter is just one of the components we have created in 2008, send us an e-mail for some more examples. Templates Send us your design (in PSD format) and we will code it to strict xHTML en CSS in no time. You will be very pleased as we work fast and reliable, and give you support afterwards. Dutch Joomla! Hosting Looking for a Dutch Joomla! Hoster that understands Joomla! completely? Try our Joomla! Proof servers. They are faster and more stable then the most hosters because we work on them ourselves and know how important it is to support Joomla! the full nine yards! Dutch Joomla! Education Living in the Netherlands and looking for an excellent Joomla! or Virtuemart training course? Check out our training courses that are given at our partner close to Utrecht: Joomla! and Virtuemart Trainings at de Karmel: http://www.dekarmel.nl/ Get in touch with us at [email protected]!

Installation To install ccNewsletter, download the package from http://extensions.chillcreations.com and unzip it. You will find the following files in it: • com_ccNewsletter - the actual component • mod_ccNewsletter.zip - the subscription module • Languages.zip - a file containing all available language files • ccNewsletter Manual.pdf - the manual you are reading now 1. 2. 3. 4. 5.

Log into your Joomla! 1.5 website and go to Extensions > Install/Uninstall Click on "Upload file & Install" and find com_ccNewsletter.zip, install it. Again, click on "Upload file & Install" and find mod_ccNewsletter.zip, and install it. You have now installed ccNewsletter component and module. Before you can use ccNewsletter you must configure it.

Upgrading from earlier ccNewsletter versions Just uninstall your old ccNewsletter version and reinstall the new ccNewsletter version. All information and subscribers/newsletters will be saved! But always check you preferences. Upgrading from spsNewsletter Just install the ccNewsletter component in your Joomla! website next to spsNewsletter as explained in above. Check to see that ccNewsletter has copied all your subscribers, configuration details and newsletters. If so, just delete the old spsNewsletter component and module, all information is now migrated to ccNewsletter. Configuration You must configure ccNewsletter before use, or it will not function correctly. 1. 2. 3. 4. 5.

Login to your Joomla! 1.5 website and go to Components > ccNewsletter Click on the icon on the right "Parameters" Fill in all fields! Otherwise ccNewsletter will not work! Click save. If you have chosen to use the Acknowledgement function, go to Components > ccNewsletter > acknowledgement and fill in all fields if necessary.

About Batch Sending When your are sending a newsletter to more then 2000/3000 subscribers, please edit the Script Timeout in the component parameters. Depending on the speed of the server, change them to a maximum of 120. But this could mean that sending all newsletters might take up to 2 hours if the server is not fast enough.

Adding other languages ccNewsletter by default has the English languages files installed. If you want to install other files, you need to get them from the languages.zip file and upload them threw FTP or when not available translate them yourself. NOTE: Not all languages are fully translated! We only have what is in languages.zip, so dont e-mail us for more... If a language is not fully translated you can do this yourself. Read on to do so! Check out the list of language short codes. 1. First of all, make sure the language you want to install is already installed as language for your Joomla! website via Extensions > Language Manager. 2. Unzip the ccNewsletter Package. 3. Find the languages.zip file and unzip it. 4. In the folder admin find your administrator language file using the short codes. See the link to the short code list if you don't know the code for your language. 5. Upload the administrator language file to the following location: administrator/ languages/xx_XX where xx_XX stands for your languages short code. 6. In the folder site find your site language file using the short codes. See the link to the short code list if you don't know the code for your language. 7. Upload the site language file to the following location: languages/xx_XX where xx_XX stands for your languages short code. 8. The languages are now installed, if the other language is active in Extensions > Language Manager, ccNewsletter will now be displayed in your language. In the languages.zip file you will now find the following languages: • Dutch • Hungarian • Norse • Turkish • French • German • Danish • Arabic • Chinese • Swedish • Italian • Spanish • Hebrew • Romanian Translating to new languages To translate ccNewsletter to your language unzip com_ccNewsletter so you can find the translation files: • admin/en-GB.com_ccnewsletter.ini • site/en-GB.com_ccnewsletter.ini Open them in a file editor (not Word!) and translate them to your language, rename them (for example Italian would be it-IT.com_ccnewsletter.ini) and send them to [email protected]. List of language short codes.

Integration with Virtuemart 1.1 If you are using ccNewsletter 1.0.2+ and Virtuemart 1.1.2+ you can integrate the two components so a user can see a ccNewsletter registration box on the following locations: • in the registration form • in the account maintenance SU Synchronization There is also a "SU Synchronization" button in ccNewsletter when Virtuemart is installed, this is another function! You don't need this function if you are using the Virtuemart integration! The SU Synchronization button will sync all clients that have ordered something in Virtuemart with ccNewsletter, this is only a good feuture to use when you have selected "No account creation" in Virtuemart and are not useing the real "Virtuemart integration".

As far as we know ccNewsletter is the only Joomla! 1.5 Newsletter that has this option and is Joomla! 1.5 Native. The integration is supported by the ccNewsletter and the Virtuemart teams, and there are no hacks used whatsoever. So you are free to upgrade any one of the components at any moment you see fit. Follow these steps to setup the integration. 1. Only follow these steps after installing ccNewsletter 1.0.2 and Virtuemart 1.1.2 2. First off all, go to Extensions > ccNewsletter 3. Click on the Parameters button in the toolbar

4. 5. 6. 7. 8. 9. 10. 11. 12.

All the way down select "Yes" at Virtuemart integration Then lets go to Virtuemart via Extensions > Virtuemart Select Admin > User Fields We need to create a new user field for the Newsletter subscription Click New Select Newsletter subscription (ccNewsletter) in Field type Fill in ccnewsletter in Field name Fill in the other information as you would like to see it. The page might look like this:

13. Click save. 14. Use the reorder function in the user field list tio order the ccNewsletter registration box to a better place. In a default Virtuemart installation position 27 is great!

15. You will also need to make a delimiter to get the box shown in a nice way. Make another user field with this configuration:

16. Also reorder this to position: 26, one above the ccNewsletter registration box. 17. You are done! Test it now by checking the registration form in the front end!