eCards Documentation

Table of Contents

How to set up the eCards plugin

Installation

  1. Upload the /ecards/ folder to your /wp-content/plugins/ directory
  2. Activate the plugin via the Plugins menu in WordPress
  3. Create and publish a new post or page, attach an image or more, and add the [ecard] shortcode
  4. Note that there is no way to attach images only in the block editor — if this is the case, use the image IDs (read more below)
  5. A new eCards menu will appear in your WordPress Dashboard

Usage

Adding eCards to a post or a page is accomplished by uploading one or more images for the [ecard] shortcode.

Images can be uploaded directly to the post or page where the shortcode is present, not attached from the Media Library. Inserting the images is not necessary, as the plugin creates the eCard automatically and displays all uploaded/attached images.

If your images are already uploaded, and they are present in your Media Library, use their IDs to display them:

[ecard id="1, 2, 3, 4, 78"]

The IDs correspond to images in your Media Library. This feature eliminates the need to manually attach images and also eliminates the need to upload the same image multiple times, just to have it attached to different posts or pages.

Add the [ecard] shortcode to a post or a page, or call the function from a template file:

<?php
if ( function_exists( 'wp_ecard_display_ecards' ) ) {
    echo wp_ecard_display_ecards();
}

Remember: If you use WordPress 4.9 or lower or ClassicPress, use the Add Images button to upload images to your post or page. Do not insert them into the page, as the plugin does it automatically.

Note: When an eCard is sent, it uses the large version of the image, as the maximum allowed email width is 600px.

Email Deliverability

To avoid your email address being marked as spam, it is highly recommended that your “From” email header domain match your website. Some hosts may require that your “From” email header address be a legitimate address.

Emails sometimes end up in your spam (or junk) folder. Sometimes they don’t arrive at all. While the latter may indicate a server issue, the former may easily be fixed by setting up a dedicated email address.

If your host blocks the mail() function, or if you notice errors or restrictions, configure your WordPress site to use SMTP. We recommend Post SMTP Mailer/Email Log.

Finally, go to the Diagnostics tab and check if your mail sending function is working.

Settings

Go to the Labels tab and configure (or translate) the strings as necessary.

The plugin is configured to use the best settings for your site, but you might want to check all the tabs — Settings, Email Options, Restrictions, and Labels — and change the options as necessary.

How to customize the eCards appearance

Recently added to our eCards plugin, a new set of options to customize the appearance of eCard thumbnails is now available.

In eCards Settings → Settings tab, check out the options below:

Card Grid

This is the number of eCards per row. The grid uses the CSS Grid Layout Module, so it works with any page builder out there.

Card Image Size

This is the size of the eCard thumbnail and, depending on your theme design, it can be square, portrait or landscape.

Card Design

This is a set of options, including box shadow, box highlighting and border radius. Note that a border can also be applied using the Custom CSS tab. An example of a black border with a white highlight is below:

.ecard-grid-item label {
    border: 3px solid #000000;
}
.ecard-grid-item label:hover {
    border: 3px solid #ffffff;
}

Card Colour Scheme

The colour scheme can be either light or dark, and it should match the overall theme of your website.

Card Accent Colour

The accent colour applies to the eCard radio boxes and the highlight border (if enabled).

Experiment with these settings to find the best design for your eCards pages.

How to design and style an eCard email

The eCards plugin features an email designer section, with a rich-text editor.

eCards Designer Settings

Here’s an example of a template. Use the following template as a starting point for your own:

You have received an eCard!

[name] sent you an eCard!

[image]

[ecard-message]

Check your eCard here: [ecard-link]

Check your eCard here (direct link): [ecard-url]

How to use IDs for specific eCard images

Sometimes you have images attached to different posts or images already existing in your Media Library. Attaching them to an eCard form is easy.

Use the desired image IDs to create a custom eCard form:

[ecard id="1, 2, 3, 4, 5"]

The IDs correspond to images in your Media Library. This feature eliminates the need to manually attach images and also eliminates the need to upload the same image multiple times, just to have it attached to different posts or pages.

This update also helps with the missing Add Media button in the block editor, which was heavily used to attach images to posts.

How to use eCard collections

Sometimes you want to create a specific eCard collection to use on one or multiple pages. Creating an eCard collection is easy.

First, create a collection by going to the eCard Collections menu item in your WordPress dashboard and selecting Add New.

Create a gallery block and add as many images as you want. You don’t need to worry about the gallery settings, as the eCard will automatically detect the image IDs inside the gallery.

Next, in your eCard form page, use the collection ID shortcode:

[ecard collection="123"]

Requirements

  • eCards plugin (latest version)
  • A gallery block or a gallery shortcode

How to set up a paywall for eCards

The eCards plugin does not have any payment gateways included. The only restriction it has is a member-only restriction.

There are other methods, however, to add an eCard page behind a paywall.

Here are 3 methods:

Use the Paid Memberships Pro plugin to create various subscription plans (or tiers), and then restrict the page (or the post) for users with a specific plan (or tier).

Restrict Content Pro

Use the Restrict Content Pro plugin to create various subscription plans (or tiers), and then restrict the page (or the post) for users with a specific plan (or tier).

Gravity Forms + Gravity Forms Stripe

Use the Gravity Forms plugin plus the Gravity Forms Stripe add-on to create a payment form, and then set up a confirmation (or “Thank You”) page with the desired eCards.

Note that there are more membership plugins out there, or even payment gateway plugins, that can be integrated with our eCards plugin.