Getting Started

Plugin installation

Install Oracle Cards

Like any other WordPress plugin, you can install Oracle Cards by uploading the
oracle-cards.zip file to your WordPress site. Follow these steps:

  1. Open your WordPress Admin panel and navigate to Plugins.
  2. Click Add New (upper left corner).
  3. Click Upload Plugin (upper left corner).
  4. Select the oracle-cards.zip file from your computer and click Install Now.
  5. WordPress will install the plugin automatically.
  6. Click Activate Plugin to finish the installation.

You can now start using Oracle Cards on your site.

Oracle Cards WordPress Plugin - Installation

License

After installation, remember to activate your license by following these steps:

  1. Go to Main Admin Menu → Settings → Oracle Cards License.
  2. Enter your email address and the license key provided in the email you received when you purchased Oracle Cards.
  3. Click Save Changes to save your license settings.

As long as your license is valid, you will be able to update Oracle Cards with one click from the Plugins page in your admin panel, and you will have access to all premium features.

Creating a deck

Main Admin Menu => Oracle Cards => Oracle Cards => Add New Deck

Set the deck name and click on “Add New Deck”

The Oracle Cards plugin will create a new empty deck of cards and open the deck settings page.Here you can choose the default card back and set the default card sizes.When you insert the deck into a page or post, you can choose a different card back and sizes that override the default settings.For the back of the cards, you can select from four built-in designs or upload your own custom image.
The titles of the cards can either have a fixed part—set in the text field—followed by a progressive number automatically assigned to each card, or they can match the titles of the uploaded images.To use the image titles, enable the checkbox “Create titles by uploaded files names”.To populate the deck, click the “Upload card front images” button.

Adding the deck to a page or post

After creating and populating the deck, you will find it in the decks listed in Main Admin Menu => Oracle Cards.

Copy the shortcode from the last column and put it into the page or post where you want it appears.

In the example shown in the image above you would copy [oracle_cards deck=”1″]

 

Here you have the list of the shortcode parameters:

Parameter Type / Accepted Values Default Description
deck integer 1 The ID of the deck to display. For example, deck="2" will load deck number 2.
show_description true / false true Whether to display the description of each card. Set to false to hide it.
show_title true / false true Whether to display the title of each card.
title_alignment left, center, right center Alignment of the card titles.
card_width integer (pixels) deck default Overrides the general deck settings for card width (in pixels) on this page only.
card_height integer (pixels) deck default Overrides the general deck settings for card height (in pixels) on this page only.
space_top integer (pixels) 0 Height of the empty space before the deck.
space_top_text integer (pixels) 0 Height of the empty space before the text.
space_top_button integer (pixels, can be negative) 0 Space between the button and the deck. Can be negative to reduce space.
maxnumber integer no limit Maximum number of cards to be displayed.
border_radius integer (pixels) 0 Corner roundness of the cards. Higher values create more rounded corners.
back_border yes / no no Whether to display a border on the back side of the cards.
back_border_color HEX color (e.g., #ffffff) #000000 Color of the back border. Only applies if back_border="yes".
custom_back_id integer (image ID) none The ID of the image to be used as the card back.
deck_from
  integer  930 If the screen width is less than this value, use the deck layout instead of the folding fan layout.
on_mobile show, hide, remove show Controls deck visibility on mobile.
show: Display the deck.
hide: Hide it via CSS (still present in HTML for crawlers).
remove: Completely remove it (requires a cache system that can differentiate between devices).
class string (CSS class) none Custom CSS class to style the deck.
deck_type varies default type If set to folding_fan, you can control card arrangement using distance and maxmargin.
distance integer (pixels) 0 or around 2 for folding_fan Space between cards in the interactive layout.
maxmargin integer (pixels) deck default Maximum margin allowed for the cards. If exceeded, the cards will overlap more closely.
button_text_mix string “Mix the cards” Text displayed on the button that shuffles the cards.
button_text_pick string “Pick your card” Text displayed on the button that allows users to pick a card.
read_more string “Read more …” Text for the “Read more” link in card descriptions.

Here are some pictures to better explain the most important parameters.

Oracle Cards | Deck Type Folding Fan

show_title

You can choose between “true” to show the title and “false” to don’t show it.

 

title_alignment

Alignment of the card titles. Possible values: left, center, right.

distance

It’s the average distance in pixels between the cards Typical values are around 2.

 

maxmargin

If the cards need more space than this space, the cards will thicken.

Single card

In the backend, you can edit the title, description, and link of each card by navigating to
Oracle Cards → All Cards and clicking the Edit link for the card you want to modify.
The title and description will appear on the screen after the card is rotated.If you also add a link, then after the card is rotated, a “Read more” button will appear. Clicking this button will open the linked page.