web/wp-content/plugins/ggis-subscribe/readme.txt
author hurons@caf4f556-3d62-0410-8435-a86758001935
Wed, 23 Dec 2009 17:55:33 +0000
branchwordpress
changeset 109 03b0d1493584
permissions -rw-r--r--
wordpress 2.8 () with the following extensions : - add-to-any - categories page - Event calendar (a custom version for IRI-Theme) - Executable PHP widget - FD feedburner - ggis subscribe - Google Xml site maple - post of current category - page redirection - related post by category AND IRI-Theme

=== ggis-Subscribe ===
Contributors: bujanga
Donate link: http://dvector.com/oracle/2008/11/04/donate-to-ggis-plugins-and-modules/
Tags: email, subscription, list, form
Requires at least: 2.5
Tested up to: 2.7
Stable tag: 0.9

Manages subscriptions to email lists. Simply add [-ggis-subscribe-] to your post.

== Description ==

ggis-Subscribe gives authors an easy way to insert a form that performs emailing list subscription management. Simply add [-ggis-subscribe-] to your post and it will create an email list subscription management form. Depending on the settings and parameters you choose, it will insert either a short form, just an email address box with submit button or a full management form.

### Features and Requirements ###

+ Wordpress 2.5 or greater
+ Designation of success page
+ An email list to subscribe to. Currently supports:
1. ezmlm lists - subscribe by sending email to listname-subscribe-your=address.com@domain.com
2. mailman lists - subscribe by sending email to listname-request@domain.com

== Installation ==

1. Download and unzip the plugin
2. Upload the ggis-subscribe to the '/wp-content/plugins/' directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Edit the ggis Subscibe options from the Settings menu.
* Add the email address of your mailing list. If you have more than one list, use commas between each address.
* Enter the URL of your thank you page (next page)
* Enter the URL of you main subscription management page.
+ Yes. Create and publish your subscription management first and then finish with your ggisSubscribe options.	
5. Place `[-ggis-subscribe-]` in your posts.


== Frequently Asked Questions ==

= Does ggis Subscibe support XXX mailing list server? =

At this time, it only supports;

1. ezmlm lists - subscribe by sending email to listname-subscribe-your=address.com@domain.com
2. mailman lists - subscribe by sending email to listname-request@domain.com

If you would like additional email server support, please submit a comment to that effect.

= Can this be used to unsubscribe? =

Yes, that is part of the full subscription management form.

= How can I adjust the form's appearance =

You should be able to fully control your form's appearance using CSS. The HTML output is fully embedded with CSS tags to make personalization easy. As an example:
>	`input.ggis-subscribe-email { width:90%; }`

== Screenshots ==

1. A screenshot of the subscription management form, screen1.png.
2. A screenshot of the ggis Subscribe Settings page, screen2.png

== Usage ==

A subscription form may be inserted on a post, page, or text widget by including the following code in your text.

>	`[-ggis-subscribe %formtype "%listname"-]`

Here is an explanation of the fields:

1. ggis-subscribe - identifies the code (required)
2. formtype - identifies the form type
* 0, default - full subscription management form
* 1 - subscribe only form , requires "listname"
3. listname - identifies the list to include in a subscription only form

### In a Widget? ###

A subscription form may be placed into the standard text widget using the methods above. For widget use, I suggest using only formtype=1, the short form.