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