=== MAZ Loader – Preloader Builder for WordPress ===
Contributors: stergosz, feataholic
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=stergosz1@gmail.com
&lc=GR&item_name=MAZ+Loader+WordPress+Preloader+Plugin&no_note=0&cn=&currency_code=USD&bn=PP-DonationsBF:btn_donateCC_LG.gif:NonHosted
Tags: preloader, site preloader, preload, page preloader, loader, loading screen
Requires at least: 4.9.0
Tested up to: 6.0
Requires PHP: 5.4
Stable tag: 1.5.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

The best WordPress Preloader plugin. Create beautiful Preloaders and makes your visitors a delight to wait for your website to finish loading.

== Description ==

<h4>WORDPRESS PRELOADER BUILDER PLUGIN</h4>

[MAZ Loader](https://feataholic.com/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) helps you add different styles of Preloaders into your site to make your users stay a delight to wait for your site to load. You do not need a developer to set up your Preloaders as its been built with ease of use in mind using our easy to use, yet powerful, Builder.

MAZ Loader allows you to create Preloaders using a variety of Fields which give you endless possibilities on how to style your Preloaders in combination with animations as well as transitions.

MAZ Loader has been built with the customer in mind making it easy to use and beginner friendly for someone who needs to build a simple to a more Preloader to someone who likes customizability.

> **MAZ Loader Pro**
> 
> This plugin is the free version of the MAZ Loader Pro plugin that comes with more features giving you more fields and more control over your Preloaders.
> 
> Features:
> * Progress Bar Field
> * Percentage Counter Field
> * Custom HTML Field
> * Lottie Field
> * Publishing Rules
> * Device Control
> * Animations
> * Transitions
> * JavaScript Events
> * Custom Code section and more!
> 
> [Click here to get started with the best WordPress Preloader plugin now!](https://feataholic.com/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)

[youtube https://www.youtube.com/watch?v=kKn29ly1R3s]

MAZ Loader Builder consists of the following sections:

* Fields List
* Fields Settings
* Loader Appearance Settings
* Loader Settings
* Custom Code [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Publish Settings [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Loader Responsive Buttons
* *Run Loader* button

Below we can find more information for each of the above sections.

<h4>Fields List</h4>

A Preloader consists of Fields which populate the Preloader's content. The available fields are the following:

* Text Field
* Image Field
* Icon Field
* Progress Bar Field [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Percentage Counter Field [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Circle Percentage Counter Field [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Custom HTML Field [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Lottie Field [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)

**Upcoming Fields:**
* Font Awesome Field

Read more on Fields on our documentationhere: [Fields Documentation](https://www.feataholic.com/wordpress-plugins/maz-loader/documentation/fields/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion).

<h4>Field Settings</h4>

All the fields mentioned provide you with a variety of settings:

* Text
* Font Size
* Text Color
* Background Color
* Padding
* Margin
* Image Upload
* Custom Image URL
* Set the Width & Height of Images
* Border Radius
* Icons (Preloaders) from a list of SVG, GIFS and CSS
* Animations [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Transitions [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Progress Bar Width [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Progress Bar Height [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Progress Bar Show/Hide Percentage [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Progress Bar Position [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Lottie Data Source (URL or JSON text) [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Custom HTML [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Custom CSS [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* Custom JavaScript [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)
* More to come... !

Read more regarding our upcoming features on our [Changelog](https://www.feataholic.com/wordpress-plugins/maz-loader/documentation/roadmap/maz-loader-roadmap/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion).

Once you have added your Fields to your Preloader, you can change their order using Drag and Drop which makes it super easy to control your content without the need to delete a Field, lose your settings and then re-create it. Duplicating a Field is also supporting with the click of a button which creates the same Field and puts it on the bottom of your Preloader's content.

Read our documentation on Preloaders here: [Preloaders Documentation](https://www.feataholic.com/wordpress-plugins/maz-loader/documentation/loaders/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion)

<h4>Loader Appearance Settings</h4>

Your Preloader can be customized via the Appearance Tab  which contains settings such as:

* Background Color: Set any color for your Preloader's background
* Background Image: Set an image as your Preloader's background
* Background Image Type: Set how the background image will appear (pattern or cover)
* Background Image Position: Set the background image position
* Loader Content Position: A list of 9 different positions for on how your Preloader's Content will appear
* Side by Side Loader Items: Set your Preloader items to appear one next to another instead of one below another. This setting does not work with all Content Positions.
* [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) Display Close Button: Show a Close button on the top right of your Preloader allowing your visitors to close it before it finishes loading.
* [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) Display Transition: Display a unique transition to your Preloader from 20+ different and unique transitions. Set any color you desire to match the theme of your site.
* Disable Page Scroll: While your Preloader is displaying you can disable the scroll bars on your page.

<h4>Loader Settings</h4>

This section handles the times of your Preloader as well as whether to display your Preloader on the homepage (If set to appear site-wide).

* Minimum Loading Time: Set the minimum time your Preloader will display
* Duration: Set the duration of your Preloader (Total duration consists of Minimum Loading Time + Duration)
* Delay: Set how long after your page started loading your Preloader will appear.
* [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) Device Control: Set where your Preloader will appear, whether it be desktop, tablet or mobile only. Target different devices based on your needs.
* [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) Limit Impressions: Limit how many times a visitor can see the Preloader in a specific time period.

* [FREE] Show on Homepage: If you have set your Preloader to appear site-wide, then you can set it to appear only on your Homepage.

<h4>Custom Code [PRO]</h4>

This section allows you to add any CSS or JavaScript you desire and let it run alongside your Preloader. This helps you customize it even further using CSS to style it the way you desire or listen to our custom JavaScript Events and run your own logic.

<h4>Publish Settings [PRO]</h4>

Publish Settings help you set where your Preloader will appear by creating conditions that determine where your Preloaders will appear across your site based on filters such as your Homepage, Entire Site, Pages, Posts, Custom Post Types, Tags or Categories. This makes it easy to make your Preloaders appear on specific pages and not on all your site.

<h4>Loader Responsive Buttons</h4>

MAZ Loader provides you with 3 buttons to show how your Preloader will appear in different devices such as Desktop, Tablet and Mobile. While clicking on each one of the buttons, the Demo Browser in the Builder will resize to try and demonstrate your Preloader in different devices.

<h4>Run Loader Button</h4>

The Run Loader button allows you to run your Preloader and see how it will work in your site before enabling it. It will auto hide itself at start and then use the Minimum Loading Time, Duration and Delay to give your a live demonstration of how it would work on your site. After the Preloader ends, it will hide itself and appear again after a second to allow you to continue editing it.

<h4>MAZ Loader Settings</h4>

MAZ Loader Settings page allow you to set the following aspects of the plugin:

* Impressions: Enable/Disable Impressions. If you disable this setting then Impressions wont be tracked whenever a Preloader is viewed by your visitors.
* Display the last published Preloader on all pages?: By enabling this, MAZ Loader will pick the last published Preloader and display it site-wide. If you disable this you can add as many Preloaders as you desire on different pages using the shortcode provided on each Preloader.
* Keep data during update?: Keep this checkbox checked in order not to lose any data while disabling/uninstalling the plugin. If you uncheck this then in case you uninstall the plugin all the data will be removed.
* License Key [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion): Set your license key to automatically get updates for your Pro version.

<h4>Shortcodes</h4>

MAZ Loader provides you with a shortcode that is unique to each Preloader. This shortcode can be viewed on the View Preloaders page and allows you to copy and paste it on a page, post, etc... and display unique Preloaders on different pages across your site.

<h4>Gutenberg Block</h4>

MAZ Loader comes pre-installed with a Gutenberg block. This block allows you to add a Preloader to your pages via the Gutenberg editor. It will overwrite any Publish Options set to the Preloader and work on the page you set it to.

<h4>Analytics</h4>

MAZ Loader provides you with Analytics by giving you information on your Preloader, Fields and Impressions. Here is a list of the provided Analytics:

* Total number of Loaders
* How many Loaders are enabled at any time
* How many Loaders have been seen from your visitors
* How many fields do your Loaders contain
* The total amount of Impressions on all your Loaders (enabled or not)
* The average impressions per Loader
* The Impressions that were recorded yesterday
* The Impressions for today
* A projection for the Impressions of the current month

<h4>Support</h4>

You can contact us if you have any questions regarding MAZ Loader using our Support Form on our site, [Contact Support](https://www.feataholic.com/contact/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion).

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/maz-loader` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the MAZ Loader menu item from the left sidebar, in your Administrator Panel, to start using MAZ Loader.


== Screenshots ==

1. MAZ Loader Dashboard
2. MAZ Loader Builder. This Preloader contains a Text Field, Image Field, Icon Field, Percentage Counter as well as a Progress Bar.
3. Text Field Settings
4. Image Field Settings
5. Icon Field Settings
6. Loader Appearance Settings Tab
7. Loader Settings Tab
8. Loader Custom Code Tab
9. Loader Publish Settings Tab: Create unique conditions and display your Preloaders anywhere on your site.
10. Tablet Preview
11. Mobile Preview

== Frequently Asked Questions ==

= Can I create multiple Preloaders? =

You can create as many Preloaders as you desire! There is no limit!

= Can I assign different Preloaders on my pages? =

Each Preloader can be assigned to any page/post/custom post type using a variety of different methods such as shortcode, Gutenberg block or via the Publishing Rules.

= Can I create a Preloader and use it sitewide? =

In the Free version, there is an option on the Settings Page (Display the last published Loader on all pages?) which is disabled by default and lets you enable it and display the last published Preloader on all pages of your website.

The [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) version gives you the possibility to create endless customizable Preloaders using the Publish Settings page.

= Can I create a Preloader and use it only on the homepage? =

As you create a Preloader, you can go to the Settings Tab > Scroll down and check the Show on Homepage to make the Preloader appear only on the homepage of your site.

The [PRO](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) version gives you the possibility to create endless customizable Preloaders using the Publish Settings page.

= Will MAZ Loader slow down my website? =

Not at all! MAZ Loader is built with performance in mind. Its front-end library consists of only 10.0 KB of CSS and 4.4 KB of JS.

= Do you provide support? =

You can contact us regarding any question on MAZ Loader using our [Support Form](https://www.feataholic.com/contact/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) on your site.

== Changelog ==

= 1.5.0 =
* Compatibility with WordPress 6.0
* Fix: Percentage Counter styling improvements.

= 1.4.2 =
* Added: Circle Percentage Counter.
* Added: "Delete Impressions" option in "View Loaders" list dropdown to clear a preloaders impressions.
* Fix: An issue where if the images preloader prevented the preloader from closing correctly under certain circumstances.
* Updated: When deleting a preloader, it should also delete all of its impressions.

= 1.4.1 =
* Fixes an issue where Preloaders could be deleted without validation.

= 1.4.0 =
* Compatibility with WordPress version 5.9
* Improves the preloading of images
* Improves Elementor compatibility.

= 1.3.4 =
* Further security improvements.

= 1.3.3 =
* Security fixes

= 1.3.2 =
* Compatibility with WordPress version 5.8
* Fix: An issue where JSON added in Lottie field wouldnt display the animation.
* Fix: An issue where the Gutenberg block wouldn't load Preloaders correctly under certain circumstances.

= 1.3.1 =
* Compatibility with WordPress version 5.7
* Lottie field can now be previewed in the back-end builder.
* Added: Loop, Number of times to loop, Width settings to the Lottie field.
* Fix: Width/Height fields can properly save the percentage character.
* Fix: Images Preloading should only occur if images have valid URLs
* Fix: Image Reset button wouldn't display the placeholder image.
* Updated: Some dashboard colors.
* Updated: The preloading of images on page load.

= 1.3.0 =
* Added: WooCommerce Products Publishing Rule to display your Preloaders within any targeted WooCommerce Product.
* Added: WooCommerce Categories Publishing Rule to display your Preloaders within any WooCommerce category or WooCommerce product that contains a specific category.
* Updated: Preloader behavior when using performance plugins that change how Javascript files are loaded.
* Updated: Dashboard to include our new plugin, [Content Promoter](https://wordpress.org/plugins/content-promoter)

= 1.2.4 =
* Updates dashboard text
* General improvements

= 1.2.3 =
* Fixed: Lottie field wasn't saving properly the URL.
* Fixed: Lottie field wasn't saving properly the JSON entered if it was larger than a specific amount of bytes.
* General improvements

= 1.2.2 =
* Fixed: An issue where some fields were not found in the previous update.

= 1.2.1 =
* Added: Limit Impressions, allowing you to limit how many times a visitor can see a Preloader in a specific time period.
* Added: Update Notifier
* Added: Sidebar in Settings page
* Updated: languages pot files
* Fix: Removes MAZ Loader menu item from non-admin users

= 1.2.0 =
* Added: Lottie Field. Add Adobe After Effects animation into your Preloaders!
* Changed: Review Reminder image now loads locally, from the plugin assets.
* Compatibility with WordPress version 5.6

= 1.1.8 =
* Fixed: An issue where some files were not included in the final zip file

= 1.1.7 =
* Compatibility with WordPress version 5.5

= 1.1.6 =
* Fixed: MAZ Loader rate reminder would not disappear on some occasions

= 1.1.5 =
* Fixed: MAZ Loader block not registering correctly on the block editor
* Fixed: When you click on a Field in the Live Preview, it should display the field settings on the left side of the Preloader Builder
* Changed: When you remove a Loader background image, it should fallback to the Background Color you have set under Appearance tab.
* Changed: Improved some field descriptions
* Added: A review reminder that appears once you activate the plugin for the first time which can be dismissed.

= 1.1.4 =
* Bumped version to 1.1.4

= 1.1.3 =
* Fixed: Back-end Preloader transition would not hide when the animation finished
* Added: MAZ Loader Submenu Page that redirects to the documentation page
* Added: MAZ Loader Submenu Page that redirects to the support page
* Added: MAZ Loader Submenu Page that redirects to the upgrade to Pro page

= 1.1.2 =
* Changed: Updated some UI elements on the back-end form
* Changed: Updated translations

= 1.1.1 =
* Changed: Updated changelog

= 1.1.0 =
* Compatibility with 5.4
* Changed: Some UI elements

= 1.0.4 =
* Fixed: In some instances you werent able to save colors with alpha

= 1.0.3 =
* Changed: Preloaders are enabled by default upon-saving
* Changed: Settings option to display Preloaders site-wide is enabled by default
* Updated: languages .pot file
* Fixed: Preloaders not appearing upon saving

= 1.0.2 =
* Introduces the [Pro](https://feataholic.com/wordpress-plugins/maz-loader/?utm_source=wprepo&utm_medium=link&utm_campaign=freeversion) version of MAZ Loader
* Added: Percentage Counter Field
* Added: Progress Bar Field
* Added: Custom HTML Field
* Added: Custom Code Section
* Added: Publish Settings Section
* Added: Loader Transitions
* Added: Field Animations
* Added: Display Close Button for your Loader
* Added: Display Transition for your Loader
* Added: Device Control
* Added: Custom HTML/CSS/JavaScript sections
* Added: Publishing Rules filtering based on Homepage, Entire Site, Pages, Posts, Tags, Categories as well as Custom Post Types
* Added: Global and Loader-specific JavaScript Events
* Added: Background overlay
* Added: Gutenberg Block
* Changed: Improved Drag and Drop of fields
* Changed: Dashboard Sidebar
* Fixed: How Loader Impressions are counted

= 1.0.1 =
* Compatibility with 5.3.2.

= 1.0.0 =
* Initial Release.