wp-greet documentation (english)

This Page contains the english manual of wp-greet, the first greetingcard plugin for wordpress.

wp-greet is a WordPress plugin to send greetingcards from your WordPress blog.
wp-greet uses the plugin NextGenGallery (http://alexrabe.boelinger.com/wordpress-plugins/nextgen-gallery/), version 0.94 or higher, to manage the greetingcards. wp-greet version 1.3 or higher requires WordPress version ≥2.5 and NextGenGallery version ≥1.0.0. It is tested with WordPress up to version 3.5.1 and NextGenGallery up to version 1.9.7.

Topic 1. to 4. of this documentation assume that you have alreay installed NextGenGallery version 0.94 or higher. If you haven’t yet installed NextGenGallery you find a short installing instruction under topic 5.

wp-greet offers several options to avoid spam and to keep spambots from using your greetingcards as spam mail. wp-greet supports the plugins Captcha!, where a captcha code has to be entered before sending a card, or the WP-reCAPTCHA Plugin, or the Math Comment Spam Protection Plugin, where a simple sum has to be calculated. You find some informations to the Captcha!-Plugin under topic 6 and to the Math Comment Spam Protection Plugin under topic 7.

This documentation relates to wp-greet version 3.2.

1. Installation and preparations:
Under “Plugins -> Add New” search for “wp-greet”, click on “Install Now” and activate the plugin. (Alternatively download and unzip wp-greet.zip, upload all files on your webspace into the directory /wp-content/plugins and activate the plugin wp-greet under ‘Plugins’.)

1.a Updating from wp-greet version 1.1 or newer:
If you have already installed wp-greet version 1.1 or newer, simply delete all old files from the directory “wp-content/plugins/wp-greet” and upload the new files, or use the automatic update function. Using either method be sure to:
- make a copy of your wp-greet.css-file and upload it after updating, if you have made any changes to it
- deactivate and reactivate the plugin once to let it execute necessary database changes

1.b Updating from a wp-greet version older than 1.1:

  • First delete the old version completely.
  • Upload the new version.
  • Deactivate and reactivate the plugin.
  • If necessary, adjust the settings in phpmailer-conf.php.
  • Delete the patched version of nggfunctions.php and copy back the original version.
  • Change all tags [gallery …] to [gallery=ID] (replacing “ID” with the gallery’s ID), the ususal way to call a gallery within NextGenGallery. The former additional parameters are no longer necessary.
  • There must be at least one page or posting containig the tag [wp-greet].
  • Adjust wp-greet’s settings in the admin-area and check the galleries you wish to use for sending as greetingcards.

2. Settings:
After activating the plugin you find in your WordPress admin menu a new menu item wp-greet with the submenus Galleries, Security and (if activated, see below) Logging. Here you can change all settings and control the logfile.

Here you can see an overview of the possible workflows:
wpgreet_ablauf_v2-4_en

wp-greet:

  • “Gallery Plugin”: the gallery plugin wp-greet will use (at the moment only NextGenGallery is possible).
  • “Form-Post/Page”: the posting or page that contains the tag [wp-greet].
  • “Mailtransfermethod”: either SMTP or PHP()mail are used to send your greetingcards. If you choose SMTP, you might have to adjust the settings in your phpmailer-conf.php, depending on your webhoster. If you choose PHP, the PHP function mail() is used. The greetingcards can only be sent inline within your mails in SMTP mode. In PHP mode the cards are sent as an attachment.
  • “Static Senderadress”: enter an E-mail adress here only if sending mails doesn’t work due to a highly secured server that you are hosted on. This adress will be used for all mails sent by wp-greet, however the reply-adress will be the entered sender’s adress.
  • “Mailreturnpath”: enter an E-mail address where undelivered cards are being sent back to.
  • “Send BCC to”: enter an E-mail address to send a copy of each sent card to (when activating this, you should inform your readers and card-senders about it).
  • “Allow more than one recipient”: allows to send a card to more than one recipient. The emailadresses in the form have to be seperated by a comma.
  • “Send image inline”: activate this when you want your graphics and pictures to be displayed within the mail and not as an attachment (only possible in SMTP mode, see above).
  • “Fetch cards online”: activate this when you don’t want the card to be sent directly to the receiver but when he should receive a notification mail with a link that leads him to a subpage of your blog where he can have a look at the card.
  • If “Fetch cards online” is activated, indicate the number of days during which the card can be picked up under “Number of days an online card can be fetched”.
  • “Online card HTML mail text”: enter the text that the receiver will see in the notification mail when “Fetch cards online” is activated. HTML is allowed, you can use the following placeholders:
    • %receiver% for the name of the receiver of the greetingcard
    • %sender% for the name of the sender of the greetingcard
    • %sendermail% for the emailadress of the sender of the greetingcard
    • %link% for the link the receiver has to click in the notification mail
    • %duration% for the time the link is valid
  • “Fixed image width”: enter a fixed width for your graphics and pictures, which should not be wider than the width of the content-area of your blog (but avoid uploading pictures of much larger size, as the scaling-down also reduces their quality).
  • “Add stamp image”: enter the path to a graphic file that wp-greet will use like a stamp in the upper right corner of every sent card. To use the stamp enclosed in wp-greet’s download package enter the path “wp-content/plugins/wp-greet/defaultstamp.jpg”. To use your own stamp just upload your own graphic and adjust the path. If you don’t want to use a stamp, leave the path blank.
  • “Stampwidth in % of imagewidth”: if you are using a stamp, enter its width here.
  • “Use NGG data for image”: The meta-informations from NextGenGallery for the display of the picture are applied. If no stamp is used, the description from NextGenGallery is additionally displayed under the picture in the form.
  • “Enable Smileys on greetcard form”: activate this if you want to enable smileys to be displayed and sent within your greetingcards.
  • When “Allow sending cards in the future” is activated, a future date can be specified when the card will be sent
  • “Use informations from profile”: activate this if you want to display your own blog’s e-mail address (‘Settings -> General -> E-mail address’) automatically as the ‘Sender’-e-mail address in the mailform.
  • “Offer ‘send again’-link”: allows the sender to send the same card with the same content once again to another recipient without typing the text again; in this case a button appears after sending or scheduling a card that says “Send this card to another recipient”.
  • “Enable logging”: activate this if you want to store data about the sent cards in your database and view the statistics under “Logging”.
  • “Default mail subject”: enter a default mail subject here (this can be overwritten by the sender).
  • “Default mail header” and “Default mail footer”: enter text here that will appear at the top and the bottom of each sent card.
  • “Number of days log entries are stored”: enter the number of days that you want the log entries to be saved.
  • “Number of days card entries are stored”: enter the number of days that you want the card entries to be saved.

Save your changes by clicking “Update Options”.

Galleries:
Check the NextGenGallery-galleries with the pictures you want to use as greetingcards.

Security:

  • “Spam protection”: choose which antispam plugin you would like to use.
  • “Minimum role to send card”: choose if either any visitor of your blog is allowed to send cards or only registered users, and which user role is necessary to send cards.
  • “Enable Terms of Usage display and check”: if you want every user to accept your terms of usage for your greetingcards before sending a card, mark this checkbox. If your theme’s footer.php contains the function wp_footer(), the terms of usage will open in a nice thickbox, otherwise they will open in a new window.
  • “Terms of usage”: If “Enable Terms of Usage display and check” is activated, you can customize the terms of usage here. HTML is allowed.
  • “Use mail to verify sender address”: By checking this box your greetingcards will not be sent directly after the “Send”-Button is hit, but the sender will receive an email containing a link he has to click. After he has done this the card will be sent to the receiver.
  • “Verification mail text”: enter the text that the sender will see in the notification mail when “Use mail to verify sender address” is activated. HTML is allowed, you can use the following placeholders:
    • %sender% for the name of the sender of the greetingcard
    • %sendermail% for the emailadress of the sender of the greetingcard
    • %receiver% for the name of the receiver of the greetingcard
    • %link% for the link the receiver has to click in the notification mail
    • %duration% for the time the link is valid
  • “Link valid time (hours)” enter the number of hours the link is valid if “Verification mail text” is activated.
  • “Confirmation mail to sender”: By checking this box the sender will receive a confirmation mail after the receiver picked up his card.
  • “Confirmation mail text”: enter the text that the sender will see in the notification mail when “Confirmation mail to sender” is activated. HTML is allowed, you can use the following placeholders:
    • %sender% for the name of the sender of the greetingcard
    • %sendermail% for the emailadress of the sender of the greetingcard
    • %receiver% for the name of the receiver of the greetingcard
    • %link% for the link the receiver has to click in the notification mail
    • %duration% for the time the link is valid
  • “Mandatory fields”: mark the fields the sender has to fill out before sending a card.

Save your changes by clicking “Update Options”.

Logging:
When “enable logging” is activated in wp-greet setup, you can view the statistics of your sent greetingcards here. Since wp-greet version 1.3 you can choose how many items are shown on one page. At the bottom of the page you can delete the logfile by clicking “Clear log”. If you click this, there will be no further request if you really want to delete – once you click the button your data will be deleted.

3. Usage:

a. Add a new gallery for your greetingcards in the administration area of NextGen Gallery and upload your greetingcards into this gallery.

b. Write a new page with the content [wp-greet] and a link underneath to the page that contains the gallery (see topic c.), for example “<a href=”http://your-domain.com/mycards”>Click here</a> to go back to the greetingcards overview”, otherwise only a blank page will be seen after sending the card. Name this page e.g. “greet”.
Then publish this page and exclude it from the pages list. If you are using widgets this is very easy: just insert the page ID under “Exclude” and click “Save Changes”. If you are not using widgets, edit the file sidebar.php and change <?php wp_list_pages(); ?> to <?php wp_list_pages(‘exclude=ID’); ?> and replace “ID” with the ID of your just published page.

c. Write another page in which your greetingcard gallery will show up. To call the gallery, insert [gallery=ID] and replace “ID” with the ID of the page from topic a. Name this page e.g. “mycards” and publish the page.

d. To send a greetingcard, browse to “http://your-domain.com/mycards”, replacing this link with your own URL. Choose one of your cards by clicking on it. Another page opens where the card in its original size appears, underneath are the fields for sender, recipient, subject and text. After filling out these fields you can click “Preview” to preview your greetingcard and then either click “Back” to go back or “Send” to send the card.

e. You can also add greetingcards into a post instead of a page. To do so, just insert [gallery=ID] like in topic c. into your post – of course by replacing ID and URL with yours.

f. The text of your greetingcards can include smilies, if this function is enabled in the options. There are a few smilies in the directory wp-greet/smilies (these are from kolobok.us), you can easily exchange them by deleting them and/or adding new ones. To change the smilies’ order just change the numbers of the gif-files.

4. Adjusting the design

To adjust the design of your greetingcard page edit the file wp-greet.css.

If you have a narrow theme you might adjust the width of the textarea
textarea.wp-greet-form { width: 90%; } by replacing the 90% with something smaller than this.

To add a border to your greetingcard preview add to your stylesheet something like
.wp-greet-form img { border: 1px solid #a9a9a9; padding: 4px;}

5. Very short instruction to the installation of NextGen Gallery:

Upload the unzipped directory nextgen-gallery into the directory wp-plugins on your webspace and activate the plugin. Click “Gallery” in the menu bar and then “Options” to adjust the settings, e.g. the path where your greetingcards will be saved, or the size of the greetingcard thumbnails.
There are further explanations and links to documentations to NextGen Gallery on the plugin’s homepage: http://alexrabe.boelinger.com/wordpress-plugins/nextgen-gallery/.

6. Short instruction to the Usage of the Captcha! Plugin:

Upload the unzipped directory “captcha” on your webspace into wp-content/plugins and activate the plugin.
To create a captcha code you need at least one truetype font. NextGen Gallery uses truetype fonts for creating watermarks in the pictures and has an integrated folder for truetype fonts. You can use this folder for Captcha! as well and don’t have to create an extra one for Captcha!.
Under “Settings/Captcha!” adjust the path to the font directory to: home/www/…/wp-content/plugins/nextgen-gallery/fonts/ and under “TTF Files” adjust the names of your fonts (you can upload more than one font into the directory). If you check “Image Distortion” it shows the captcha images in a distorted way, which is a more effective spam protection but also harder to read for humans.

After saving your settings you can deactivate the plugin. If you do so, the captcha protection only shows up on your greetingcards pages. If you do not deactivate it a captcha protection is added to your comment form, so that every commenter on your blog has to type a captcha code before sending off a comment.

7. Short instruction to the Usage of the Math Comment Spam Protection Plugin:

Upload the unzipped directory “math-comment-spam-protection” on your webspace into wp-content/plugins and activate the plugin. Under Settings -> Math Comment Spam klick “Update Options” once even without having changed any options, otherwise the plugin won’t work. You don’t have to change the text of the error messages here as these are fixed within wp-greet.
If you don’t want to use the plugin for your comments form as well, you have to deactivate it after updating the options.

Kommentare

  1. Rick Young:

    Hi I am having trouble getting the gallery to open with the form under it. I have made pages as in the docs the mycards page uses code [gallery=1] gallery number. the other page uses the [wp-greet] and the link under it. and named /greet/

    Thanks

    Rick

    Antworten

    • tuxlog:

      Hi again Rick,

      did yout try what I wrote this morning?

      Antworten

    • tuxlog:

      Well, if it still does not work you can send me admin access via email, so I can have a look at it.

      cheers, Hans

      Antworten

  2. Rick:

    d. To send a greetingcard, browse to “http://your-domain.com/mycards”, replacing this link with your own URL. Choose one of your cards by clicking on it. Another page opens where the card in its original size appears, underneath are the fields for sender, recipient, subject and text. After filling out these fields you can click “Preview” to preview your greetingcard and then either click “Back” to go back or “Send” to send the card.

    I can not get it to got to the next step when clicking on gallery image, all pages have been created as in the doc.

    Thanks

    Antworten

    • tuxlog:

      Hi Rick,

      can you please go to the wp-greet admin dialog and select the form page again and then click save. Sometimes this was the reason for not getting connected to the gallery. You can also send me a link so I can have a look at it.

      Cheers, Hans

      Antworten

  3. Pekka Ollikainen:

    Hi ,

    In our project I have prepared finnish translation of wp-greet language file. So far I wrote both fi_FI.mo and fi_FI.po files and have put those into our server.
    But I quess I need to change wp-greet configuration files somwhere as well in order to get my finnish language set activated. Could you point me to right direction in order to find right files where this can be done? Also is there some specific syntax I need to use ther in order to get it running.
    I gladly post our finnish version to wp-greet but first I want to see how it works live in the site and maybe do some edting first before posting back to you,
    BR: Pekka Ollikainen

    Antworten

    • webmaster:

      Hello Pekka,

      you have to rename the file to wp-greet-fi_FI.mo and wp-greet-fi_FI.po and put them into the wp-greet/lang directory.
      If you blog is set to finish language the translation should be pulled in automatically.
      Looking forward to extend wp-greet with the finish translation.

      Cheers, Hans

      Antworten

  4. Ilona:

    Hello,
    I made a translation into Polish language as it was suggested in the readme.txt file.
    But I don’t know how to apply it. There is no menu to choose language in my wp-greet. Will somebody, please help me.
    Best regards
    Ilona

    Antworten

    • Ilona:

      Help no more needed, I found out by myself :))
      Anyway thank you for great plugin
      Best regards
      Ilona

      Antworten

      • webmaster:

        Hello Ilona,

        if you like to share your translation just send it to me and I will gladly add it to the next release of the plugin.

        Have Fun, Hans

  5. Angel:

    Hello Hans,

    all my wp content is under /ld-content/,
    so i changed the source to reflect this replacing
    wp-content with ld-content and now have smiles and almost all working. Only the image is not fetched.
    Looking forward to solve this.
    Kind Regards,

    Angel

    Antworten

    • webmaster:

      Hello angel,

      oops, did I miss your last reposne? Sorry. If anything is left to discuss, please gimme a sign.

      Regards, Hans

      Antworten

      • Angel:

        Hello Hans,

        thanks for your support. I still didn’t found why wp-greet 3.2 don’t work on one of my sites. I thing that is incompatibility between Better WP Security plugin which changed a lot of settings, including wp-content default folder. I didn’t have enough time to investigate the exact reason, but once I find the problem will report you. Thanks again for your good work and support.
        Best Regards,
        Angel

  6. Angel:

    i checked out and i thing the plugin don’t work if the wordpress content folder has other name that wp-content. will look the src code later to find why.

    best regards,

    angel

    Antworten

  7. Angel:

    Hello Hans,
    thanks again for the great plugin and support.
    I added wp-greet 3.2 to the other site, but send email page did not shows the card :/ Any suggestion please?
    http://ldstyle.com/postales/feliz-8-de-marzo/
    i saw that the uri of the card is correct, but something wrong with showing it on the send card page.
    The other site with the same version of the plugin and almost the same config works fine:
    http://ideasnavidad.es/postales-navidad/nacimiento-navidad/
    can you help me please to find the problem?
    thanks in advance for your comments
    best regards
    Angel

    Antworten

    • webmaster:

      Hello Angel,

      I just visited the site and it strikes that a new tab or window is opened when I click on one of the images in the gallery. This is not a wp-greet “feature”. Do you have any idea where this comes from? What other plugins do you use? In the form the smilies are missing too.

      Cheers, Hans

      Antworten

      • Angel:

        Hello Hans,
        thanks for the fast replay. The site uses open in new tab plugin, which works fine here too:
        http://ideasnavidad.es/postales-navidad/papa-noel/
        the problem on
        http://ldstyle.com/postales/postales-3d/
        i think is that the wp-content folder has other name. all the content exept the gallerys is located here. only the nextgen gallery resides on wp-content folder. this change was made with better wp security and i think the plugin is incompatible with this setting. I’ll try to uninstall the plugin and check for hard coded wp-content/plugins path. Will keep you informed with the results. Thanks!

  8. alex:

    Hi,

    i ve got the plugin working… everything fine till you send the card. I do receive the confirmation mail but the card is no receiving.

    Checked junk folder ect….

    Please help…

    Antworten

    • webmaster:

      Hello alex,

      can you see in the log that the card is sent? Can I try your installation somewhere?

      Thanks, Hans

      Antworten

      • alex:

        yes, please have a look at http://www.tonmotion.de … click on “emotions club”, register and then click on “grusskarten”.

      • alex:

        and yes… in the log it said “sent confirmation”

  9. Morgan Barnhart:

    Hi there! I’m really excited to start my greeting cards, but I can’t seem to get it working. I’ve gone through this entire tutorial and followed everything to the letter but all I get is this: http://zombieresponseteam.net/greeting-cards/ and error saying I’m not allowed to send an ecard. What am I doing wrong?

    Antworten

    • Morgan Barnhart:

      Ok, I fixed that problem, but now I can’t seem to get the images to show up.

      Antworten

      • webmaster:

        Hello Morgan,

        did you setup a gallery? Then connect the gallery to wp-greet in the wp-greet admin dialog. If you choose one of the pics you should be directed to the card form with the image.
        The message that you are not allowed to send an ecard means you have to set the permissions wright. This can be done at the wp-greet admin dialog under security. E.g. select Everybody and Save.
        Regards, Hans

  10. Angel:

    Hello Hans,

    thanks for the mail with spanish translation. One question more, please. The plugin converts my animated gifs to nonanimated jpg. Can I avoid this and conserve the original gif format (as is on gallery)? Any suggestion, please?

    Thanks in advance!

    Angel

    Antworten

    • webmaster:

      Hello Angel,

      as far as I can see on your site you have activated the stamp feature which is not working with animated gifs. Disable the stamp (clear the stamp image input field and save it) and it should work.

      All the best, Hans

      Antworten

    • Angel:

      Hi, again – I found the solución. Just disabled stamped funcion. Thanks!

      Antworten

      • Angel:

        Hello Hans,

        thanks for quick response. It’s OK now. As I will mantain this and other sites with greetcards I can help to beta testing for the new release. I’m a developer (c/c++, php, j2ee) and linux administrator (mainly centos, ubuntu)

        Best wishes
        and

        Merry Christmas!

        Angel

      • webmaster:

        Hello Angel,

        this would be great. The new beta is just out and you can fetch it via http://www.tuxlog.de/wp-content/downloads/wp-greet-3.2.zip.

        See the readme.txt file for changes

        Merry Christmas, Hans

Hinterlasse eine Antwort

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind markiert *

Du kannst folgende HTML-Tags benutzen: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

:bye: 
:good: 
:negative: 
:scratch: 
:wacko: 
:yahoo: 
B-) 
mehr...
 
Blogverzeichnis - Blog Verzeichnis bloggerei.de