{"id":267,"date":"2018-03-12T03:42:20","date_gmt":"2018-03-12T03:42:20","guid":{"rendered":"http:\/\/veno.es\/magicards\/?page_id=267"},"modified":"2026-06-10T08:26:51","modified_gmt":"2026-06-10T08:26:51","slug":"documentation","status":"publish","type":"page","link":"https:\/\/veno.es\/magicards\/documentation\/","title":{"rendered":"Documentation"},"content":{"rendered":"\n
\n
\n

Magicards Documentation<\/h1>\n\n\n\n

Magicards<\/strong> is a professional WordPress plugin designed to create interactive card decks, memory games, and content grids. It is optimized for the Gutenberg block editor but remains fully compatible with all major page builders.<\/p>\n<\/div>\n\n\n\n

\n

1. Installation<\/h2>\n\n\n\n
    \n
  1. Download the magicards.zip file.<\/li>\n\n\n\n
  2. Go to your WordPress Dashboard: Plugins > Add New > Upload Plugin<\/strong>.<\/li>\n\n\n\n
  3. Select the file, click Install Now<\/strong>, and then Activate<\/strong>.<\/li>\n<\/ol>\n<\/div>\n\n\n\n
    \n

    2. Global Settings<\/h2>\n\n\n\n
    \n
    \n
    \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div>\n\n\n\n
    \n

    Once activated, a new Magicards<\/strong> menu will appear in your WordPress admin sidebar. Here you can configure the global defaults for your decks:<\/p>\n\n\n\n

      \n
    • Card Size:<\/strong> Define the default width and height (in pixels) for your card thumbnails.<\/li>\n\n\n\n
    • Deck Controls:<\/strong> Customize the position and alignment of the interface buttons, and set custom text for the “Shuffle” and “Toggle” buttons.<\/li>\n\n\n\n
    • Info Panel:<\/strong> Set the default global colors for the card back (Background, Title, and Text colors).<\/li>\n\n\n\n
    • Share:<\/strong> Configure social sharing options, including the tools title, specific socials to display, and default sharing links\/titles.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
      \n

      3. Using the Gutenberg Block (Recommended)<\/h2>\n\n\n\n
      \n
      \n

      The most intuitive way to build your card decks is through the native WordPress Block Editor:<\/p>\n\n\n\n

        \n
      1. Open a Page or Post.<\/li>\n\n\n\n
      2. Click the (+)<\/strong> button and search for the Magicards<\/strong> block.<\/li>\n\n\n\n
      3. Configure your deck (images, columns, behavior) using the inspector sidebar on the right.<\/li>\n<\/ol>\n<\/div>\n\n\n\n
        \n
        \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div>\n<\/div>\n\n\n\n
        \n

        \ud83d\udca1 Pro Tip:<\/strong> Magicards works perfectly in other page builders like Elementor<\/strong>, WPBakery<\/strong>, or Beaver Builder<\/strong>. To generate a custom shortcode easily: insert the Gutenberg block into a draft page, configure it exactly how you want, click the three dots in the block toolbar, and select “Edit as HTML”<\/strong>. Copy the resulting shortcode and its attributes, then paste it into your favorite builder as a standard shortcode.<\/p>\n<\/blockquote>\n<\/div>\n\n\n\n

        \n

        4. Shortcode Attributes Reference<\/h2>\n\n\n\n

        When using the [magicards]<\/code> shortcode manually or via the “Edit as HTML” method, use the following parameters:<\/p>\n\n\n\n

        Attribute<\/strong><\/td>Description<\/strong><\/td>Default<\/strong><\/td><\/tr>
        ids<\/td>Comma-separated list of attachment IDs for the cards<\/td>“”<\/td><\/tr>
        backface<\/td>Attachment ID for the image used as the card back<\/td>0<\/td><\/tr>
        col<\/td>Number of columns in the grid<\/td>4<\/td><\/tr>
        num<\/td>Total number of cards to display<\/td>1<\/td><\/tr>
        thumbsize<\/td>The WordPress image size used for the cards<\/td>magicard-thumb<\/td><\/tr>
        updown<\/td>Allow cards to appear upside down (0 or 1)<\/td>0<\/td><\/tr>
        description<\/td>Enable\/Disable the info panel description (0 or 1)<\/td>0<\/td><\/tr>
        share<\/td>Enable social sharing buttons (0 or 1)<\/td>0<\/td><\/tr>
        memory<\/td>Enable Memory Game mode (0 or 1)<\/td>0<\/td><\/tr>
        onecard<\/td>Enable Single Card draw mode (0 or 1)<\/td>0<\/td><\/tr>
        noshuffle<\/td>Disable the random shuffle (0 or 1)<\/td>0<\/td><\/tr>
        notoggle<\/td>Disable the manual flip toggle (0 or 1)<\/td>0<\/td><\/tr>
        radius<\/td>Border radius of the cards (in pixels)<\/td>0<\/td><\/tr>
        panel_bg<\/td>Hex code for the info panel background<\/td>#333333<\/td><\/tr>
        panel_title<\/td>Hex code for the panel title text<\/td>#ffffff<\/td><\/tr>
        panel_text<\/td>Hex code for the panel description text<\/td>#ffffff<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        Example:<\/strong>[magicards ids=\"10,11,12\" backface=\"5\" col=\"3\" memory=\"1\" radius=\"10\" panel_bg=\"#000000\"]<\/code><\/p>\n<\/div>\n\n\n\n

        \n

        5. Content Customization<\/h2>\n\n\n\n

        Magicards pulls data directly from your WordPress Media Library<\/strong> items to populate the cards and the info panel:<\/p>\n\n\n\n

        \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
          \n
        • Caption:<\/strong> Displays as the main heading<\/strong> in the info panel.<\/li>\n\n\n\n
        • Description:<\/strong> Displays as the body text<\/strong> in the info panel.<\/li>\n\n\n\n
        • Upside down:<\/strong> A specialized field that replaces the default Description if the card appears reversed (only when updown is enabled).<\/li>\n\n\n\n
        • Title and Alt Text:<\/strong> Used for accessibility and SEO.<\/li>\n<\/ul>\n<\/div>\n\n\n\n
          \n

          6. Advanced Layouts<\/h2>\n\n\n\n

          You can apply specialized layouts by adding these classes to the “Additional CSS classes”<\/strong> field in the block settings:<\/p>\n\n\n\n

            \n
          • cross-layout (9 cards, 3 columns)<\/li>\n\n\n\n
          • h-layout (9 cards, 3 columns)<\/li>\n\n\n\n
          • star-layout (6 cards, 3 columns)<\/li>\n\n\n\n
          • plus-layout (9 cards, 3 columns)<\/li>\n\n\n\n
          • x-layout (9 cards, 3 columns)<\/li>\n<\/ul>\n<\/div>\n\n\n\n
            \n

            7. Custom CSS<\/h2>\n\n\n\n

            Each Magicards block supports custom CSS. Use the .magicard-item selector to target specific card styles. Styles added via the Gutenberg block are scoped to that specific page for optimal performance.<\/p>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

            Magicards Documentation Magicards is a professional WordPress plugin designed to create interactive card decks, memory games, and content grids. It is optimized for the Gutenberg block editor but remains fully compatible with all major page builders. 1. Installation 2. Global Settings Once activated, a new Magicards menu will appear in your WordPress admin sidebar. Here […]<\/p>\n","protected":false},"author":2,"featured_media":309,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"inline_featured_image":false,"footnotes":""},"class_list":["post-267","page","type-page","status-publish","has-post-thumbnail","hentry"],"yoast_head":"\nMagiCards Documentation: WordPress Plugin Guide & Setup - MagiCards<\/title>\n<meta name=\"description\" content=\"MagiCards documentation. Learn how to install the plugin, configure your card decks, and use shortcodes for Tarot and interactive layouts.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/veno.es\/magicards\/documentation\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"MagiCards Documentation: WordPress Plugin Guide & Setup - MagiCards\" \/>\n<meta property=\"og:description\" content=\"MagiCards documentation. Learn how to install the plugin, configure your card decks, and use shortcodes for Tarot and interactive layouts.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/veno.es\/magicards\/documentation\/\" \/>\n<meta property=\"og:site_name\" content=\"MagiCards\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-10T08:26:51+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/veno.es\/magicards\/wp-content\/uploads\/2018\/03\/preview-hires.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1180\" \/>\n\t<meta property=\"og:image:height\" content=\"600\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@nicolafranchini\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/documentation\\\/\",\"url\":\"https:\\\/\\\/veno.es\\\/magicards\\\/documentation\\\/\",\"name\":\"MagiCards Documentation: WordPress Plugin Guide & Setup - MagiCards\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/documentation\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/documentation\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/veno.es\\\/magicards\\\/wp-content\\\/uploads\\\/2018\\\/03\\\/preview-hires.jpg\",\"datePublished\":\"2018-03-12T03:42:20+00:00\",\"dateModified\":\"2026-06-10T08:26:51+00:00\",\"description\":\"MagiCards documentation. Learn how to install the plugin, configure your card decks, and use shortcodes for Tarot and interactive layouts.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/documentation\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/veno.es\\\/magicards\\\/documentation\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/documentation\\\/#primaryimage\",\"url\":\"https:\\\/\\\/veno.es\\\/magicards\\\/wp-content\\\/uploads\\\/2018\\\/03\\\/preview-hires.jpg\",\"contentUrl\":\"https:\\\/\\\/veno.es\\\/magicards\\\/wp-content\\\/uploads\\\/2018\\\/03\\\/preview-hires.jpg\",\"width\":1180,\"height\":600},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/documentation\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/veno.es\\\/magicards\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/#website\",\"url\":\"https:\\\/\\\/veno.es\\\/magicards\\\/\",\"name\":\"Magicards - Wordpress plugin\",\"description\":\"Set a deck of cards, shuffle, draw.\",\"publisher\":{\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/#organization\"},\"alternateName\":\"Magicards\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/veno.es\\\/magicards\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/#organization\",\"name\":\"Magicards - WordPress plugin\",\"url\":\"https:\\\/\\\/veno.es\\\/magicards\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/veno.es\\\/magicards\\\/wp-content\\\/uploads\\\/2018\\\/03\\\/preview-hires.jpg\",\"contentUrl\":\"https:\\\/\\\/veno.es\\\/magicards\\\/wp-content\\\/uploads\\\/2018\\\/03\\\/preview-hires.jpg\",\"width\":1180,\"height\":600,\"caption\":\"Magicards - WordPress plugin\"},\"image\":{\"@id\":\"https:\\\/\\\/veno.es\\\/magicards\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/x.com\\\/nicolafranchini\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"MagiCards Documentation: WordPress Plugin Guide & Setup - MagiCards","description":"MagiCards documentation. Learn how to install the plugin, configure your card decks, and use shortcodes for Tarot and interactive layouts.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/veno.es\/magicards\/documentation\/","og_locale":"en_US","og_type":"article","og_title":"MagiCards Documentation: WordPress Plugin Guide & Setup - MagiCards","og_description":"MagiCards documentation. Learn how to install the plugin, configure your card decks, and use shortcodes for Tarot and interactive layouts.","og_url":"https:\/\/veno.es\/magicards\/documentation\/","og_site_name":"MagiCards","article_modified_time":"2026-06-10T08:26:51+00:00","og_image":[{"width":1180,"height":600,"url":"https:\/\/veno.es\/magicards\/wp-content\/uploads\/2018\/03\/preview-hires.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_site":"@nicolafranchini","twitter_misc":{"Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/veno.es\/magicards\/documentation\/","url":"https:\/\/veno.es\/magicards\/documentation\/","name":"MagiCards Documentation: WordPress Plugin Guide & Setup - MagiCards","isPartOf":{"@id":"https:\/\/veno.es\/magicards\/#website"},"primaryImageOfPage":{"@id":"https:\/\/veno.es\/magicards\/documentation\/#primaryimage"},"image":{"@id":"https:\/\/veno.es\/magicards\/documentation\/#primaryimage"},"thumbnailUrl":"https:\/\/veno.es\/magicards\/wp-content\/uploads\/2018\/03\/preview-hires.jpg","datePublished":"2018-03-12T03:42:20+00:00","dateModified":"2026-06-10T08:26:51+00:00","description":"MagiCards documentation. Learn how to install the plugin, configure your card decks, and use shortcodes for Tarot and interactive layouts.","breadcrumb":{"@id":"https:\/\/veno.es\/magicards\/documentation\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/veno.es\/magicards\/documentation\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/veno.es\/magicards\/documentation\/#primaryimage","url":"https:\/\/veno.es\/magicards\/wp-content\/uploads\/2018\/03\/preview-hires.jpg","contentUrl":"https:\/\/veno.es\/magicards\/wp-content\/uploads\/2018\/03\/preview-hires.jpg","width":1180,"height":600},{"@type":"BreadcrumbList","@id":"https:\/\/veno.es\/magicards\/documentation\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/veno.es\/magicards\/"},{"@type":"ListItem","position":2,"name":"Documentation"}]},{"@type":"WebSite","@id":"https:\/\/veno.es\/magicards\/#website","url":"https:\/\/veno.es\/magicards\/","name":"Magicards - Wordpress plugin","description":"Set a deck of cards, shuffle, draw.","publisher":{"@id":"https:\/\/veno.es\/magicards\/#organization"},"alternateName":"Magicards","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/veno.es\/magicards\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/veno.es\/magicards\/#organization","name":"Magicards - WordPress plugin","url":"https:\/\/veno.es\/magicards\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/veno.es\/magicards\/#\/schema\/logo\/image\/","url":"https:\/\/veno.es\/magicards\/wp-content\/uploads\/2018\/03\/preview-hires.jpg","contentUrl":"https:\/\/veno.es\/magicards\/wp-content\/uploads\/2018\/03\/preview-hires.jpg","width":1180,"height":600,"caption":"Magicards - WordPress plugin"},"image":{"@id":"https:\/\/veno.es\/magicards\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/nicolafranchini"]}]}},"_links":{"self":[{"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/pages\/267","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/comments?post=267"}],"version-history":[{"count":44,"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/pages\/267\/revisions"}],"predecessor-version":[{"id":841,"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/pages\/267\/revisions\/841"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/media\/309"}],"wp:attachment":[{"href":"https:\/\/veno.es\/magicards\/wp-json\/wp\/v2\/media?parent=267"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}