=== dlb's Send-A-Link === Contributors: DrandLomB Donate link: Tags: email, send, link, send link, send email, email post Requires at least: 3.5.1 Tested up to: 3.5.1 Stable tag: 0.4 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Send-A-Link allows visitors to send someone an email containing a link to the post or page and some comments. == Description == *dlb's Send-A-Link* allows visitors to send someone an email containing a link to the post or page and some comments. Key features include: - A shortcode can be put in your template(s) to show visitors an icon or text link to send an email. - The input form, confirmation page, and email message are all based on easily modifiable HTML templates. - Send-A-Link loads fast because code is compact and does not use jQuery. - Send-A-Link uses Javascript/AJAX for fast, inobtrusive form handling. - Built and tested on WordPress v3.5.1; might work on earlier versions, but has not been test on them. The Send-A-Link code is heavily commented, especially regarding WordPress plugin interfaces and AJAX features. This makes it a suitable starting point for novice developers to explore their own programming interests. I have attempted to make the code very understandable, but I do not claim this to be *model* code because I am not an experienced developer myself. In fact, I would greatly appreciate constructive criticism. In the future, as time permits, I plan to develop subsequent versions to implement features such as the following, in approximately this order: - Privacy reassurance that email addresses are not stored, but IP's are - Log mail sent with user's IP address to a file - Throttle sends to some number per time period from a given IP - Provide full functionality without Javascript - Localize to be ready for translation, including delivery of po and mo files and some instruction on how to use POEDIT to customize the wording, regardless of language. This could especially apply to the error messages. - Rewrite using class construction - Add admin screens to modify things now defined as constants and templates - Move logging into database - Make it easy to turn CAPTCHA off or on - Make it easy to use other CAPTCHAs == Installation == 1. Copy the contents of file `dsl.zip` into the `/wp-content/plugins/` directory 1. Activate plugin "dlb's Send-A-Link" through the "Plugins" menu in WordPress 1. Place shortcode [dsl-link] in your templates where you want the link to appear 1. Optionally, customize as described in the FAQ == Frequently Asked Questions == = How can I change the wording and styles in the email message and on the Send-A-Link pages? = Most of the visible elements are defined in the template and CSS files. You can make your modifications to a *copy* of them stored in your theme folder so that they are retained when you upgrade to a new version of Send-A-Link. = What are the template and style file names? = The input form template is `dsl-page.html`. The confirmation page and email message templates are in file `dsl-templates.html`. The CSS styles are in file `dsl.css`. = Can I change the icon and text in the link? = Yes, by using the following shortcode parameters: `[dsl-link show="both" iconfile="Your-Icon.gif" text="Your Text" ]`. The value of `show` can be one of "icon", "text", or "both" to display only the icon, only the text or both. The value of `iconfile` must be the name of your file with a path relative to the plugin folder. The value of `text` will be the title which is typically shown as a tooltip, and will be displayed if `show` is either "text" or "both". = How can I change the wording in the error messages? = In this version the error messages must be changed by editing file `dsl.php`, which is heavily commented to make it easier to navigate and alter the code. A future release will make this easier by using the WordPress localization system. == Changelog == = 0.4 = Initial release: * Allows visitors to send someone an email containing a link to the post or page and some comments. * Provides a shortcode to put into templates to show an icon or text link to send an email. * The input form, confirmation page, and email message are based on HTML templates * Customized CSS styles and templates can be stored in the theme * Uses Javascript/AJAX for fast, inobtrusive form handling. * Loads fast, based on compact code that does not use jQuery. * Code is heavily commented, especially regarding WordPress plugin interfaces and AJAX features. * Built and tested on WordPress v3.5.1; might work on earlier versions, but has not been test on them. == Upgrade Notice == = 0.4 = Initial release.