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:


  • „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“.

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


  • „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“.

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.


  1. kaleem Peeroo:


    I am trying to use the plugin but having some difficulties connecting the gallery. Followed your instructions above and gallery displaying thumbnails of cards in „mycards“ page but when I click on one card, no action is taken and it does not load into form filling page.

    I had to change [gallery=1] where „1“ is the id of gallery given in „MyGreet“ –> „Galleries“ and not „39“ which is my page ID of „mycards“ for the cards to appear. I connected and linked „mycards“ from NGG „Galleries“ –> „Manage Galleries“ to „mycards“.

    Please advise.


    • tuxlog:


      I am not sure I understood you right. First step is adding a page with the wp-greet shortcode, then add a gallery to a page, then select the first page as formapge in wp-greet admin dialog (please double check this and in doubt save it again), the connect gallery to wp-greet using the wp-greet gallery dialog. If you like, send me an admin acount for your page and I will have a look.

      Cheers, Hans


  2. Manny:

    Hi Tuxlog,

    I like it so far, easy setup but hope it works. Wondering if you can help me, I’m trying to do everything as described but I am facing the same challenges as those who have posted before me. Anyway, you can kindly explain what I am doing wrong?

    1. Create wordpress Gallery per your other article.
    2. Connect wp-greet to wordpress from dropdown menu in wp-greet setup page.
    3. use shortcode [wp-greet]

    I can see the gallery, but it looks like it has nothing to do with wp-greet form! can’t select images to be in the greeting card. I think it may have something to do with the shortcode im using or something. Even the recaptcha doesn’t work, it just says recaptcha without actually displaying the plugin (which is compatible with wp-greet)

    Please help


    • tuxlog:

      Hello Manny,
      please check if the in the gallery settings the Link to parameter is set to media file not attachment.
      This should do the trick.


  3. Jeff VanderWal:

    I’m having a hard time figuring out how to install and configure this plugin properly. I think I’ve done all the steps as you listed, but it still does not seem to click from the gallery to the send page and when I send from a post page, no picture is ever sent inline (SMTP is enabled). It displays as „wp-greet card image“ instead. I am using NextGen Gallery and when I click on the image, it opens the image in a new window. I think I’ve made a total mess of things. My page is at http://ecardfoundry.com to keep in line with your instructions. Can you please advise?



    • tuxlog:

      Hello Jeff,

      I just visited your website and it seems the gallery is not connected to wp-greet. Can you confirm that you connected the gallery via the wp-greet admin dialog under galleries?
      Second thing is if you use NGG you have to patch one file since they removed some hooks. Did you manage to change the corresponding index.php?

      Cheers, Hans


  4. salim:

    Hi Team,
    I am new to wordpress , I am trying to create a web app for greeting cards. I found wp-greet plugin serves my purpose, but when i try to use it ,I am facing some issue.
    I gone through above instructions on USAGE of this plugin, but i cant understand it clearly .
    So kindly provide me some sample code or sample instruction for following
    1. adding gallery image to a page
    2.creating a page with content [wp-greet] and excluding the page [this option is not available in wordpress 4.1]. this is the ‚greet‘ page
    3.creating a page named “mycards“ which links to the gallery page with code [gallery id="47"]. the id of gallery page.

    I am using following versions.
    wordpress: 4.1
    Next gen galery Version

    Really looking for a positive reply.

    Salim S


    • tuxlog:

      Hello salim,

      did you connect the gallery to wp-greet (wp-greet-> galleries)? And did you select the correct formpage in the wp-greet admin dialog and save it?

      Cheers, Hans


  5. Mohamed:


    i have a problem in the gallery page http://trezeltd.staging.wpengine.com/mycards/ as when clicking any image, it doesn’t open the form page http://trezeltd.staging.wpengine.com/greet/ and just open the image

    i don’t use and lightbox plugin and i’m using „shutter“ effects

    Any help please in connecting the gallery page to forms page?

    Thank you


    • tuxlog:

      Hello Mohamed,
      as far as I can see something changes the links of the thumbnail images after wp-greet modified the links. You can see this if you have a look at the html source and check the data-src attribute of the a tag. It contains the correct link for wp-greet.

      Can you describe your environment a bit mor in detail or send me an admin account to your site please.

      Cheers, Hans


      • Mohamed:


        Can you please tell me your private mail and i’ll create new backend user for you?

        Thank you

      • Mohamed:

        Thank you Hans! it works now :)

Schreibe einen Kommentar

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

ALL-INKL.COM - Webhosting Server Hosting Domain Provider Blogverzeichnis - Blog Verzeichnis bloggerei.de