WP iEcard Documentation

Documentation, Reference Materials and Tutorials for Ecard


View Demo

Introduction

WP iEcard is a WordPress eCard plugin used to send ecards to your buddies. The plugin is very simple to use. Start your own eCards site! or create your own ecard store with payment gateway. Setup an ecard store for Valentine’s Day, Mother's day, Easter or Halloween and many more. Enjoy ecard!!

Features:

Here you will find the main features which are included in our iEcard Plugin.

  • Create multiple ecard store like category.
  • Five inbuilt ecard form style.
  • Five inbuilt ecard image listing style with masonary layout.
  • Better UI representation to the user.
  • WordPress media uploader for ecard images. Choose ecard images for media gallery.
  • Easy Drag & Drop features for ecard images.
  • Display image title and description. Tell something about image.
  • PayPal Payment integration while sending ecard.
  • Better email representation for ecard.
  • Admin notification when ecard was sent.
  • Track how many ecard was sent.
  • Track number of sent for ecard image also!!.
  • Track how many ecard was sent by site login user.
  • Choose different price for different different ecard store.
  • Choose which ecard image size you want to display.
  • Open ecard images in a popup for better visualization.
  • Manage ecard form fields label, placeholder and enable/disable it per ecard wise.
  • Google reCaptcha integration with ecard form.
  • Manage ecard success message and error message per ecard wise.
  • Better ecard log system for sent ecard for admin.
  • Restriction for site guest members, login member or members with particular roles.
  • Success page globally or per ecard store wise after ecard was sent.
  • Settings tab for plugin.
  • 100% multilanguage - iEcard is completely translatable both in front and back-end.

Installation of Plugin

  1. The installation of the plugin is just like any other plugin installation for WordPress. Login to your WordPress site and go to Plugins > Add New.
  2. At the Install Plugins Page click on Upload from the top navigation and then click on browse.
  3. Choose the downloaded plugin zip file and upload this zipped file. Please unzip the file first to get the plugin zip file.
  4. Now click on Install Now.
  5. Wait until WordPress has uploaded the file. If it's done click on Activate Plugin.
  6. Now you plugin is activated and you can see a message 'Plugin activated' at the top of the window.

Plugin Settings

Plugin settings page holds various settings. These are the global plugin settings. Some settings can be overwritten from the ecard settings.

General Settings

General Settings

Ecard Restriction
Select your ecard privacy. Choose guest member or both guest and login member can see your ecard store.

Member Roles
If you select Ecard restriction to 'Only Member Can Access' then this option will be visible to you. You can select particular user roles to access ecard store.
Note: If you do not select any role then ecard store will be available to all logged in user. Guest user can not access it.

Ecard Restriction Custom Message
Display your desired message instead of ecard forms for non-logged-in users or non authenticated user.

Thank You Page
Select ecard thank you page. User will be redirected to thank you page after completing ecard process. You can choose different thank you page per ecard store wise form the ecard settings.
You can choose any of your site page or enter any external page link also.

Google reCaptcha Settings

Google reCAPTCHA is a free service to protect your website from spam and abuse. Configure reCaptcha site key and secret key to use it. You can know more details on Google reCaptcha.

You can Enable / Disable it for particular ecard form the ecard settings and configure it's various settings form their like reCaptcha Theme, reCaptcha Type and etc.


Email Settings

Email settings holds the various email related settings for the ecard.

Email Settings

Email Template
Choose an email template for ecard.

Logo
Upload or choose your site logo which will be displayed at the top of the emails. This option will work only in HTML emails template.

From Name
Enter from name for email which will be displayed in sent ecard email address as from name.

From Email
Enter from email for ecard email which will be displayed in sent ecard email address as from email. This will be used as Reply-To email address also.

Subject
Enter subject line for ecard email.

Additional Headers
Enter some additional headers for email like `Reply To` and etc. This option is useful when you are using any dedicated email address as from Email address then simply you can set Reply-to to sender email address rather then your email address.
Please enter proper data within this otherwise it causes failure email delivery.

Ecard email body
You can say this ecard email footer body. This will be added after the user message. You can display any addition information at the end of email address.

Admin Email Notification

Enable/Disable
Check the box if you want to enable the email notification when ecard is sent.

Recipient(s)
Enter the email address(es) as comma separated that should receive a notification when an ecard is sent.

Subject
Enter the subject line for the admin notification email.

Admin email body
Customize the email that is sent to admin. You can use varios template tags inside that which will provide you the information about the sent ecard.


Payment Gateways Settings

Payment Gateways Settings holds the payment related settings like PayPal for the ecard.

Payment Gateways Settings

Test Mode
Check the box if you want to test ecard payment process in test payment gateway. While in test mode no live transactions are processed. To use test mode, you must have a sandbox or test account for the payment gateway you are testing.

Enable PayPal Standard
Check the box if you want to enable the PayPal Standard as payment gateway for ecard.

PayPal Email
Enter the PayPal account's email.

Currency Code
Enter currency code in which you want to get payment. Read more about PayPal Currency Codes and Accepted Currency.


Custom CSS Settings

You can simply override plugin css form here.

Custom CSS Settings

Here you can enter your custom css for the plugin. The css will automatically be inserted to the header of theme, when you save it.


Misc Settings

These are the plugin miscellaneous settings.

Misc Settings

Disable Font Awesome CSS
Check the box if your theme or any other plugins uses the font awsome css. Ecard plugin will not enqueue it's own CSS.

Disable Magnific Popup CSS/Js
Check the box if your theme or any other plugins uses the Magnific popup css and js. Ecard plugin will not enqueue it's own CSS and Js.

Ecard Post Settings

These are the ecard post meta box settings. Control ecard price, design, form fields, form messages and etc.

Ecard Settings

Ecard Post Settings

Choose Ecard Images
Choose your desired images for ecard via WordPress media uploader. Hold Ctrl key to select multiple images at a time.
You can drag & drop images to desired order. You can enter image title and description to display at ecard store with images.

Ecard Price
Enter your ecard price if you have enabled the payment gateway. You can leave empty for free sending.

Ecard Image Sizes
Select appropriate ecard image size to displayed at ecard store.

Ecard Image Template
Select ecard image design template how it looks at ecard store.

Ecard Image Title
Check the box if you want to display the image title at ecard store.

Ecard Image Description
Check the box if you want to display the image description at ecard store.

Ecard Quick View
Check the box if you want to enable the quick view popup when user hover of ecard image. User can see better image with this option.


Ecard Form Settings

Ecard Form Template
Select ecard form design template how it looks at ecard store.

Ecard Title
Check the box if you want to display the ecard title in form.

Ecard Description
Check the box if you want to display the ecard description in form.

Ecard Restriction
Select ecard privacy. Leave blank to use from plugin settings.

Thank You Page
Select ecard thank you page. User will be redirected to thank you page after completing ecard process. Leave blank to use from plugin settings.

Custom Thank You Page URL
You can enter thank you page URL.


Ecard Form Fields Settings

Ecard Form Fields Settings

Submit Button Text
Enter ecard form submit button text. Default text is Send.

Ecard Name Field
This is the ecard form `Name` field. You can Enable/Disable, Provide label, Provide placeholder and Make it required.

Ecard Your Mail Field
This is the ecard form `Mail` field. You can Provide label and placeholder to it.

Ecard Your Friend Mail Field
This is the ecard form `Friend Mail` field. You can Provide label and placeholder to it.

Ecard More Recipients Field
This is the ecard form `More Recipient` field. You can Enable/Disable, Provide label, Provide placeholder and Provide the extra Recipients Limit.
Extra recipients email beyond the limit will be neglected.

Ecard Message Field
This is the ecard form `Message` field. You can Enable/Disable, Provide label, Provide placeholder and Make it required.

Ecard Send Copy to Self Field
This is the ecard form `Self Copy` checkbox field. You can Enable/Disable and Provide label to it.

Ecard Terms & Service Field
This is the ecard form `Terms and Service` checkbox field. You can Enable/Disable, Provide label and choose Terms & Service Page.

Google reCaptcha Field
This is the `Google reCaptcha` field in ecard form. You can Enable/Disable, Provide label and choose reCaptcha Theme, reCaptcha Type and reCaptcha Size.


Ecard Form Fields Message Settings

Ecard Form Fields Message Settings

Control various messages for ecard form like Success message, Validation message, Error message, Required field message, Invalid email message, Terms & Service Field message, Captcha validation message and etc.

Add Shortcode

To setup the ecard store into any page or post at any position you can use the [wp_iecard id="XX"] shortcodes.
Note: Please enter the shortcode into 'Text' tab of WordPress plugin editor without 'code' HTML tag.

You will find the plugin shortcode at the ecard listing. Please see below image.

Plugin Shortcode

Shortcode Parameter

id
This is the ecard id for which you want setup the ecard store. You will find ecard id from the admin panel at ecard listing page.

grid
This is the number of columns for ecard image. You can set it upto maximum 4 columns. [wp_iecard id="23" grid="3"]
Note: For some of the 'Ecard Image Template' grid parameter will not work. Like 'Ecard Image Column 1 - Landscape' because some of the designs will not set in grid layout.

Template Structure -- Override templates via a theme

The WP iEcard is made with WordPress standard and it is developer friendly. The plugin contains some markup files within the /templates/ directory.

If you want to customize any markup related to front end, You just need to copy these files to your theme directory.

Note: Do not customize these files directly within the core plugin itself as they are overwritten during the upgrade process and your customizations will be lost.


  • ecard-custom-msg.php
  • ecard-img-stats.php
  • ecard-magnific-popup-data.php
  • ecards/
    • ecard.php
    • ecard-header.php
    • ecard-form-fieldset-style.php
    • ecard-form-input-box-anim.php
    • ecard-form-simple.php
    • ecard-form-single-column.php
    • ecard-form-two-column.php
  • ecards-img/
    • ecard-img-column-1-landscape.php
    • ecard-img-columns.php
    • ecardecard-img-columns-masonary.php
    • ecard-img-flat-columns.php
    • ecard-img-flat-columns-masonary.php
  • emails/
    • header.php
    • footer.php
    • body.php
    • email-cnt.php
    • email-cnt-default.php

Template Override Example:
To override the ecard-header.php file then simply copy /wp-iecards/templates/ecards/ecard-header.php to Your-theme/wp-iecards/ecards/ecard-header.php

Can't find the answer you are looking for?

If you have any questions that are which are not listed in documentation, Feel free to get in touch with us on support@infornweb.com