web/wp-content/plugins/ggis-subscribe/readme.txt
branchwordpress
changeset 112 fb7cd02b9848
parent 111 6b96085291d7
child 123 561aa6d282f6
equal deleted inserted replaced
111:6b96085291d7 112:fb7cd02b9848
     1 === ggis-Subscribe ===
       
     2 Contributors: bujanga
       
     3 Donate link: http://dvector.com/oracle/2008/11/04/donate-to-ggis-plugins-and-modules/
       
     4 Tags: email, subscription, list, form
       
     5 Requires at least: 2.5
       
     6 Tested up to: 2.7
       
     7 Stable tag: 0.9
       
     8 
       
     9 Manages subscriptions to email lists. Simply add [-ggis-subscribe-] to your post.
       
    10 
       
    11 == Description ==
       
    12 
       
    13 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.
       
    14 
       
    15 ### Features and Requirements ###
       
    16 
       
    17 + Wordpress 2.5 or greater
       
    18 + Designation of success page
       
    19 + An email list to subscribe to. Currently supports:
       
    20 1. ezmlm lists - subscribe by sending email to listname-subscribe-your=address.com@domain.com
       
    21 2. mailman lists - subscribe by sending email to listname-request@domain.com
       
    22 
       
    23 == Installation ==
       
    24 
       
    25 1. Download and unzip the plugin
       
    26 2. Upload the ggis-subscribe to the '/wp-content/plugins/' directory
       
    27 3. Activate the plugin through the 'Plugins' menu in WordPress
       
    28 4. Edit the ggis Subscibe options from the Settings menu.
       
    29 * Add the email address of your mailing list. If you have more than one list, use commas between each address.
       
    30 * Enter the URL of your thank you page (next page)
       
    31 * Enter the URL of you main subscription management page.
       
    32 + Yes. Create and publish your subscription management first and then finish with your ggisSubscribe options.	
       
    33 5. Place `[-ggis-subscribe-]` in your posts.
       
    34 
       
    35 
       
    36 == Frequently Asked Questions ==
       
    37 
       
    38 = Does ggis Subscibe support XXX mailing list server? =
       
    39 
       
    40 At this time, it only supports;
       
    41 
       
    42 1. ezmlm lists - subscribe by sending email to listname-subscribe-your=address.com@domain.com
       
    43 2. mailman lists - subscribe by sending email to listname-request@domain.com
       
    44 
       
    45 If you would like additional email server support, please submit a comment to that effect.
       
    46 
       
    47 = Can this be used to unsubscribe? =
       
    48 
       
    49 Yes, that is part of the full subscription management form.
       
    50 
       
    51 = How can I adjust the form's appearance =
       
    52 
       
    53 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:
       
    54 >	`input.ggis-subscribe-email { width:90%; }`
       
    55 
       
    56 == Screenshots ==
       
    57 
       
    58 1. A screenshot of the subscription management form, screen1.png.
       
    59 2. A screenshot of the ggis Subscribe Settings page, screen2.png
       
    60 
       
    61 == Usage ==
       
    62 
       
    63 A subscription form may be inserted on a post, page, or text widget by including the following code in your text.
       
    64 
       
    65 >	`[-ggis-subscribe %formtype "%listname"-]`
       
    66 
       
    67 Here is an explanation of the fields:
       
    68 
       
    69 1. ggis-subscribe - identifies the code (required)
       
    70 2. formtype - identifies the form type
       
    71 * 0, default - full subscription management form
       
    72 * 1 - subscribe only form , requires "listname"
       
    73 3. listname - identifies the list to include in a subscription only form
       
    74 
       
    75 ### In a Widget? ###
       
    76 
       
    77 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.