~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Program Description ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ D-Mack RecommendFriends Version v2.0.3 - January-06-2009 is a component to allow your users to recommend your website to their friends. It can send multiple emails, number defined in Admin, with the friends name, and copy the Administrator and/or the User. It also incorporates Captcha Security to help prevent spam and the option to send Content-Type:text/html MIME format! ALL text for the entire component, front end and back, can be edited on-line in the Admin area of the site. And the component is XHTML 1.0 Transitional valid! This component uses standard Joomla! JFactory Mailer functions - which should work if your website's email settings are correctly configured for your website server (i.e. Sendmail, PHPMailer, SMTP, etc). Now with several Language (translations) Files: German - de-DE.php - Front End (Thank You Fabian Metzner!) English - en-GB.php - Entire Component Spanish - es-ES.php - Entire Component (Thank You Luis J. Pumares!) French - fr-FR.php - Entire Component (Thank You Patrick Atlas!) Italian - it-IT.php - Front End and most of Back End (Thank You Andrea Garbato!) Dutch - nl-NL.php - Entire Component (Thank You Adri 'CanBerra' Dekker!) Polish - pl-PL.php - Front End (Thank You Stanislaw Kordasiewicz!) Russian - ru-RU.php - Front End (Thank You Denis S.!) Turkish - tr-TR.php - Front End (Thank You Sedat Oguz!) This is a 100% Free Component (GNU/GPL License) - You are ABSOLUTELY ALLOWED to modify any of the files to your liking. The only thing I ask is to let me know if you have improved the script so I might also improve the script and re-release it to the community. Thanks! If you have any suggestions or have found a bug, please contact us by mail: info at dmackmedia.com ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Linking to the Component ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To add a link to the Main Menu (mainmenu) if you want everyone (Public) to be able to use this component, follow these steps: 1. Click the Menu->Main Menu link 2. Click on 'New' in the top right part of the screen 3. Choose the 'D-Mack Recommend Friends' Component from the list 4. Type in a Title for the link 5. Type in an Alias for the link 6. Don't need to change the Parent Item 7. Click the 'Publish' radio button 8. Make sure the Link's Access Level is set to 'Public' 9. And Finally, click 'Save' and you should be good to go! To add a link to the User Menu (usermenu) if you want only 'Registered' users to use this component, follow these steps: 1. Click the Menu->User Menu link 2. Follow steps 2 through 7 shown above... 3. Make sure the Link's Access Level is set to 'Registered' 4. And Finally, click 'Save' and you should be good to go! You can also set the component parameters by clicking Component->Recommend Friends->Configuration on the Main Admin Menu above. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Program Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ As of this version (RecommendFriends v2.0.3 - January-06-2009) there are many great configuration settings for the component. ------------------------------------------------------------------------------ The Administrator can set how many 'Email Fields' are displayed on the Front End. ------------------------------------------------------------------------------ It is possible to select how the 'From' and 'Reply To' addresses are set. If selected (checked), the 'From' and 'Reply To' email addresses in the email sent to the Friend(s) will be set to the User. If NOT selected, the 'From' email address will be set with the site 'Administrator' email address and the 'Reply To' email address will be set with the User's email address. ------------------------------------------------------------------------------ It is possible to set whether the site Administrator should receive a copy (Bcc) of every email sent to the user's 'Friends'. If you have a large, active site with many users, you may want to disable this option as you possibly could receive many emails. If selected (checked), the Admin email will be set in the Bcc field so it will not be visible to most users. ------------------------------------------------------------------------------ You can change or customize the 'Subject' field for the emails. There is a checkbox that determines whether to use the custom subject field or not. Unfortunately you are not able to use custom tags or formatting at this time. It should be text only. ------------------------------------------------------------------------------ You can also set a customized introduction message for the emails sent to Friends. There is also a checkbox for this that will enable/disable the use of the introduction message. This can be a great way to get more members for your site. You could list the features and benefits of your site that will hopefully entice friends to join. If you have a 'Referral' program setup, this would be a great place to describe how it works, what the benefits are for a new member and explain the benefits for the User who sent the RecommendFriends emails. ------------------------------------------------------------------------------ There is also and option to allow/enable HTML code to be entered in the custom introduction. Enabling the option will send all the Emails as Content-Type:text/html MIME format. You can use any HTML code in the message, but you can NOT use any other codes (PHP, Javascript, etc.) in the custom field. ------------------------------------------------------------------------------ There many ways to change the appearance of the form fields in the front end - now including the form field widths! Using custom color selectors, you can change the form field backkground and text colors, the form field validation alert background and text colors as well as the background and text colors that display the username and email address for logged in users. ------------------------------------------------------------------------------ RecommendFriends v2.0.3 - January-06-2009 also includes Captcha Security! *NOTE* Your website server *MUST* have GD Library enabled as well as True Type Fonts! You can choose if you want use it or not, as well as set many variables for the image including the width, height, text rotation, set all colors (background-text-noise) by using custom color selectors, choose the font type and set the number of characters displayed in the image. ------------------------------------------------------------------------------ ** ALL ** text that is displayed on screen for this component, including the front end, admin configuration text and what you are reading now, is called through the included language file(s) in the includes folder - and now it can all be edited ** ON-LINE ** through the component! Feel free to change the text any way you like. If you have translated the text into a different language (other than English), please contact me so I can include your Language file into the component distribution! Thanks! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Warranty ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. ------------------------------------------------------------------------------ If you have any suggestions or have found a bug, please contact us by mail: info at dmackmedia.com D-Mack RecommendFriends component - v2.0.3 - January-06-2009 - is licensed under GNU/GPL. ****** You are ABSOLUTELY ALLOWED to modify any of the files to your liking! ****** If you find a bug or improve the script in any way, please let the community know by adding comment(s) either on the Extensions page or in the Forums. And Most of All... Have Fun!