Overlay Manager add-on

Documentation for v1.5 and later


Introduction

Before going through documentation chapters, thanks for purchasing Overlay Manager add-on and trusting LCweb!

Need further help?

Open a ticket

Need a customization?

Ask for a quote

Installation

Create and Manage Overlays

Layers overlap

By default graphical layers overlapping reflects the order you used in the builder and the textual block is always on top of them.
To force graphical layers to stay over texts, use the "Layer over text block" option.

Layers position

Graphical layers are always shown over item's image, while textual block follows "text under images" rule as set in grid's shortcode.

Item's excerpt

Enabling the add-on, you'll see the excerpt field added in "edit item" page.
Leaving it blank, a shortened version of item's description is used instead.

Socials

Involved social icons reflect the ones enabled in Media Grid settings. Remember that Google+ is usable only having deeplink active.

Custom content layer

This layer may execute HTML and global shortcodes

Items date and author

Use these placeholders %AUTHOR% - %DATE% to show related data.
They can be used in text description, excerpt or custom content layers.

WooCommerce - items price

Use %WC-PRODUCT-PRICE% placeholder to show product's price in overlays.
It can be used in both text description, excerpt or in custom content layer

Inline icons

Media Grid integrates FontAwesome, then you can also use them in textual overlays.
Here's an example: <i class="fas fa-check-square"></i>

Use Overlays

"(default one)" option, in shortcode's wizard field, is related to the global option you declared under Media Grid settings

Shortcodes

Add-on shortcodes are usable ONLY in textual layers or in item excerpts

[mgom-item-attr name="" label="0" icon="0"]

Displays custom attributes. If an attribute doesn't exist or is empty, returns nothing:

name attribute name. Is CASE SENSITIVE, then be careful using the exact attribute
label boolean flag to display/hide the attribute label. Use 1 to enable
icon boolean flag to display/hide the attribute icon. Use 1 to enable

[mgom-type-txt type=""] some text [/mgom-type-txt]

Displays contents only for a specific item type. Here's the types list

simple_img Static image
single_img Single lightbox image
img_gallery Lightbox images slider
video Lightbox video
inl_video Inline video
audio Lightbox audio
audio Lightbox audio
link Link items
lb_text Custom Content
woocom WooCommerce product
post Any other post type you may use in grids

[mgom-mgaf-sect slug=""]

Requires Advanced Filters add-on and displays items data related to a specific filter's section.
Use section's slug as SLUG parameter

Multilanguage

The plugin is 100% multilanguage for both front and back ends. If a translation of your language has been created, WordPress will automatically switch between languages.
Plus it is compatible with WPML and Polylang!

How to create a translation

If you have WPML + String Translation add-on or Polylang, you can simply scan the plugin and translate strings via its UI.

Otherwise: go in the plugin folder, then open the one named "languages".
Inside you'll find the default.pot file. It contains english strings to be translated.

If you want to create or customize one your language translation, follow these steps:

  1. Open the default.pot file with POedit
  2. Edit the catalog by inserting your data and setting translation's language
  3. Save the file with your language's i18n identifier and "mgom_ml-" prefix (the italian example is mgom_ml-it_IT)
  4. Go to plugin's folder ".. wp-content/plugins/media-grid-overlay-manager/languages" and paste resulting .PO and .MO files

If you create new translations, please contact me at support@lcweb.it sending your .PO and .MO files.
Otherwise they will be lost in next updates. Thanks!

LCweb - Copyright © 2019 - All Rights Reserved