Introduction
Item Name: Molecule Slider & Gallery WordPress Plugin
Item Version: 1.0.0
Author: UI-CLAN
License: Codecanyon Split License
Twitter: UI-CLAN On Twitter
Hello! Welcome to Molecule WordPress Plugin Documentation. First of all, we convey our sincere gratitude for visiting our site. We want to assure you that development of the plugin is a continuous process and you will find the plugin a seamless one across all platforms and browsers.
We shall remain thankful to you in providing "Free Lifetime Updates of the Plugin and Continuous Support", if you have become a clan member of our UI-CLAN family by purchasing a plugin license.
We have compiled here the whole documentation of Molecule. This documentation is to help you in understanding each feature of the plugin. Please go through the document carefully and you will realize how easy and effective it is to use Molecule for your WordPress powered site. We can reassure that your experience with Molecule will be smooth and seamless and you will realize that you started your journey on the right footing.
General
This section contains list of all plugin related requirements, hosting suggestions and configuration, plugin package structure etc.
Plugin Requirements
To install and use Molecule on your site, you must be running WordPress 4.5 or higher, PHP 5.6.30 or higher, and MySQL 5 or higher. You need to have the following values setup for your site's PHP configuration. Contact your host to find out if they support these requirements.
How To Verify Current PHP Configuration
You need to verify the PHP version that is currently installed on your site. You have got couple of options on how to find the exact version. Remember, Molecule requires atleast PHP 5.6.30 to work correctly. To find the correct version of PHP you can -
-
1
Ask your hosting provider
Ask your hosting provider to tell you the configuration. If the required conditions are not met, ask them to increase the limits. -
2
Install plugin
You can also check the PHP configuration by installing this simple plugin called WP-ServerInfo. -
3
Use FTP and upload a file.
If you have FTP access to your site, upload this below file to your site root directory. This should be the same folder in which the wp-config.php exists. Once uploaded access this file using your site url as [your-site-url]/phpinfo.php. You need to extract the file from inside the zip download. Download the file
Use right-click and then choose "Save Link as" to save the file.
Note: Molecule Requirements
The above mentioned PHP configuration values are recommended for smooth working of Molecule. The plugin will mostly work with even lower config, but for large sites, or while trying to import some demos, you might face some problems if the recommended configuration is not met.
File structure
We've prepared a very intuitive file structure. Please click on the folders below to see what's inside.
Below is a full list of everything that is included when you download the main files.
- molecule
- molecule.zip
- molecule-docs
- docs.html
- Licensing
- GPL.txt
- README_License.txt
For your convenience, the whole Molecule plugin directory structure has been added here for reference. You can see which files are in which folder and update/modify them accordingly.
- admin
- class-molecule-admin.php
- classes
- elements
- fields
- functions
- ajax.php
- helpers.php
- screens
- class-molecule-admin-editor.php
- class-molecule-admin-home.php
- class-molecule-admin-settings.php
- app
- css
- fonts
- Feather
- Feather.eot
- Feather.svg
- Feather.ttf
- Feather.woff
- Feather
- img
- js
- languages
- molecule.pot
- public
- templates
- vendors
- molecule.php
Browser Support
Specifically, we support the latest versions of the following browsers and platforms. On Windows, we support Internet Explorer 11+. More specific support information is provided below.
-
Chrome
-
Safari
-
Opera
-
FireFox
-
IE 11+
Extended Plugin Support
Since the new CodeCanyon terms have come out on September 2015, getting item support is a paid feature. Your purchase of Molecule comes with 6 months of free support. You need to pay $7.88 approximately to extend support to 12 months.
You can read more about the new support terms below.
No need to pay extra for 6 months
With Molecule plugin you are guaranteed support for 6 months upfront without any extra fees than the price for the plugin license. Remember, item support do not include customizations and support for 3rd party plugins.
The Envato system will suggest that your support has expired and you need to renew support. However, it is not required. Our ticketing system is not bound to Envato's system and works differently. However, do understand that to get support beyond 6 months you need to renew your support with Envato. Until then you can use our system to submit tickets for your issues and bug reports and we will solve them for you.
Getting started
To get started you need to download the plugin package from CodeCanyon "Downloads" section.
When you purchase Molecule on CodeCanyon, you need to download the plugin files from the downloads section of your Envato account. Navigate to your downloads tab on CodeCanyon and find Molecule. Alternately, you can click this link here to go to your downloads page. If you have bought it recently, it should be on the top. Next, click the download button to see the two options. The "All files & documentation" contain the whole plugin package and has a large download size. The "Installable WordPress file only" consists of just the installable WordPress plugin zip file molecule.zip.
Signup For Support
We provide support for Molecule plugin customers using our advanced and secure ticketing system. To use our system you need to signup with a verified purchase code.
-
1
Visit Downloads Page
To get the purchase code you need to visit the "Downloads" section in your CodeCanyon account. -
2
Download License Certificate & Purchase Code
You can then download and purchase the license term and certificate in either txt or pdf format or both. -
3
Get Your Purchase Code
Next you need to find the purchase code inside the downloaded document. -
4
Create A New Account
The next step would be to create a new account on the Molecule Ticket Support Page.
License Terms
Molecule Plugin can be purchased using the "Regular Licensing" or "Extended Licensing" option.
The license and billing are controlled by Envato and you can read more about them on the Envato license terms page. We do not control any sales or the licensing of the plugin. If you want to know more about the license you can contact us or Envato directly for clarification.
Regular License Terms Extended License TermsLicense FAQs
-
Do I need to purchase second license if I want to use Molecule on more than one site?
Yes. Every license of Molecule entitles you to use the plugin on a single site. If you wish to use the plugin on more than one complete website, you need to purchase a second license of the plugin. -
Can I use Molecule on a development / test site?
Yes. You can use Molecule plugin on as many test sites as you want. You can use the plugin to build your site on a development site, then move it to the live site. Remember, you will need separate license for each of your live sites. -
Can I use the plugin for client work?
Yes. Each license of Molecule allows you to use the plugin for a single end client. That means if you have 10 clients you will need 10 separate license of Molecule plugin for all of them. -
Can I use the plugin on Multi site?
You need to have separate license for each of the subsites in a multisite setup irrespective of whether the subsites are individually or separately owned. -
Where can I learn more about Molecule license terms?
If you have further queries about Molecule and it's licensing terms, you can contact us directly using the ticketing system if you are a customer or email us at hello@uiclan.com.
Recommended Hosts
Molecule plugin can only be installed on self-hosted WordPress sites and not on WordPress servers. You can host it on WordPress.com if you have a business account. Otherwise, you will require a good hosting company to host your site.
With over 4 years of experience, we recommend you two web hosting companies that have time and again provided exceptional customer service and reliable hosting solutions. Please note, while we might receive a small commission for recommending these hosts, our recommendation is based purely on the quality of their services which is miles ahead of the others. These two hosting companies are -
Installation
You can install the plugin either by using WordPress or via FTP. The molecule.zip file that you find in the plugin download package is what you need to upload to your site.
Download Molecule from CodeCanyon
-
1
Visit the "Downloads" page.
After you have purchased the plugin you need to download the Molecule plugin package from the downloads page. For that go to "Downloads" tab from your account screen. -
2
Select the download package.
Once there, you need to select the type of package you want to download. You can download the all files package that has everything like documentation, licensing and the plugin files or only the "installable plugin package" that is the molecule.zip file. -
3
Download the package.
Once you have selected, the download will begin automatically. Based on your selection and your internet speed, the download will take some time. -
4
Extract the plugin package.
The downloaded plugin package then needs to be extracted using an appropriate application. We recommend 7-zip for Windows or build-in extract tool for Mac to extract the contents of the package. If you had choosen the "installable plugin package" option, then you need not extract anything and the downloaded zip file is what you can upload to your site.
WordPress Dashboard Installation
Install WordPress via the admin dashboard backend. Install From The Admin Dashboard (RECOMMENDED).
-
1
Go to Plugins > Installed Plugins.
-
2
Click Add New and then click the Upload Plugin button.
-
3
Upload Molecule plugin
Navigate to find the "molecule.zip" file on your computer and click "Install Now". -
4
Activate the plugin
Activate the newly installed plugin by going to Plugins > Installed Plugins and clicking the Activate button.
Install Using FTP
Here we have shown how to use this method on the FTP client Filezilla.
-
1
Open FTP & Add Account
Go to "Open the Site Manager" link on top and add a new site. We hope you are using the latest version of FTP client. We have shown how to use this method on FileZilla.
-
2
Add a New Site
In the site manager add the necessary FTP login and password and hostname, save the data and login. If you cannot find the necessary information ask your hosting provider to help you. If you are using cPanel, you will find everything you need in the "FTP Account" section.
-
3
Navigate to wp-content/plugin
Next step is you need to navigate to the wp-content/plugin directory on your remote site. It is on the right window. In the local directory go to where the "molecule" folder is placed.
-
4
Upload Molecule
Make sure that the remote directory points to plugin folder. Upload the plugin directory on the left window to the remote site by right-clicking and choosing upload. If there is a warning message choose "Overwrite" and "Apply to current queue only" and hit OK.
Note: What to upload when?
If you are using the admin dashboard method, use zip file - molecule.zip
If you are using the FTP method use folder - molecule
All of these can be found in the molecule-complete package. Incase you download the Installable plugin File, you can use the file to install via the admin dashboard method. You will need to extract the plugin folder from the downloaded zip file in order to use the FTP method.
-
1
Molecule Auto Updater
The first and easiest method is to simply register your purchase to access our automatic plugin updater. -
2
Install via WordPress Dashboard
The second is the standard method of installing the plugin via the admin dashboard. -
3
FTP Method
You can use the FTP method to update the plugins. It is however recommended to delete the existing files or overrite them while you perform the upload. -
4
Envato Market PluginYou can use the Envato's official Market plugin hosted on Github to perform plugin updates.
Note: Important Steps Before Updating Plugin
No matter which method you use to update Molecule, here are some of the
most important steps that you should take.
1. Before you update, check update notes.
2. Make a backup of your database - VERY HIGHLY RECOMMENDED.
3. Take a backup of the molecule sliders by exporting them.
Support Desk
Every license of Molecule plugin comes with 6 months of technical support and completely free lifetime updates of the plugin.
Once the 6 months of included support is up, you have the option to extend the support period to 6 or 12 months for a nominal fee. If you do not extend your support, you will still be able to submit bug reports via email or Envato's comments section for Molecule plugin and still have access to our online documentation and knowledge base and video tutorials and other support resources.
You can also contact us via Twitter or E-mail.
Previously, purchasing a plugin license entitled you to unlimited support and lifetime updates. But recently, the Envato license terms have been updated related to item support. You can view the updated terms here http://codecanyon.net/page/item_support_policy
Support Does Not Include :
1. Customization and installation services.
2. Support for third party software and plug-ins.
Technical Plugin Support
To get technical support from the UI-CLAN team, you have to use our ticketing system to contact us.
We use a friendly, advanced and secure ticketing system. Support is limited to questions regarding the plugin's features or problems with the plugin. We are not able to provide support for code customizations or third-party themes and/or plugins. If you need any help with more than just minor customizations of your plugin installation, consider asking a professional developer for help as we may not be able to offer such services. You need to follow the steps below to submit a ticket.
-
1
Sign Up To Create Your Support Account
Visit this page to create your support account or login to an existing account. -
2
Enter Your Purchase Code
If you have not created your account yet, you need to enter a valid purchase code to access the ticketing system. This has to be done once only when you sign up. -
3
Sign Up For Support
You then need to signup to get access to support. If you need help again you can then login using the same credentials. -
4
Follow Steps
You will then be asked to provide your necessary details and explain your plugin related issues. -
5
Submit Ticket & Wait For Reply
Once you hit submit, your ticket will be registered with us and we will contact you very soon, usually within 24 hours.
- Make sure your question is a valid plugin issue since we do not provide customization services.
- Check if the documentation or any related video guides can solve your issue.
- Try disabling the active plugins one-by-one to confirm that there is no conflict with any of them. However, if there are any conflicts, kindly let us know.
- If you have performed customizations in the plugin, confirm that you didn't make an error. If you have made changes and can't find the issue, kindly inform us about such changes.
- Most issues can be solved by doing a simple search on the internet. You may be able to solve your issue yourself quicker sometimes by following this suggestion.
- Ticketing System
- Envato Comments Section
Renew Or Extend Support
Once you have purchased Molecule plugin you have the option to extend support while your purchase date is less than 6 months from the current date and there is less than 6 months support remaining.
The cost of extending or renewing support varies according to your purchase date with respect to when you have purchased the plugin. So, extending support during plugin purchase will cost 30% of list price in comparison to 50% during 6 months. The image below explains how the pricing is set. Kindly note that all support extension pricing percentages are set by Envato and not by us.
To know more you can read the Envato article on "Extending and Renewing Item Support".
Extending and Renewing Item Support
-
1
Sign in To CodeCanyon Acccount
Sign into Envato account and go to the "Downloads section. There you will find under the Molecule plugin, a link to renew/extend the support. Click on the "Extend Now" or "Renew Now" button.
-
2
Renew / Extend Support
Once you click on the link you will be redirected to the plugin description page. There you will see a section on the right as shown in the image. Click of the "Renew Support" or "Extend now and save" link to update your support.
-
3
Checkout
Once you click on the button you will then be taken to the checkout page. There provide your payment details and follow the provided instructions to complete your transaction.
-
What happens if I forget to renew or entend my support?
Once the support period is over, you will not receive ticket support from the UI-CLAN team. However, you will have continued support for 6 months from the date of purchase of Molecule plugin and thereafter if extended. -
What will I have access to after the support period has expired?
The complete online documentation, plugin updates, twitter access, knowledgebase, tutorials, polling and other support resources will still be available. The only support that you will not receive is the one-to-one direct support from the plugin authors. -
What does support include?
Support includes fixing plugin bugs and to make Molecule work on your WordPress site. We will help to solve possible compatibility related issues. Support also involves continuous lifetime updates for as long as you want. -
What does support not include?
Support does not include helping with customizations. Support also does not come with hosting or plugin installations or website setup. Support for 3rd party plugins and themes are also not provided. -
Will you help me with Molecule plugin issues?
Indeed. As a valued Molecule plugin customer you get full one-on-one support from the plugin developers. We will help you with every feature Molecule has to offer and also try to include your most requested features in future versions. We will help you to solve plugin related issues that you come across through personalised e-mail.
Changelog
You can find the version history (changelog) in the item description page for the latest changes or you can see the entire development history for Molecule since launch, online in the changelog page.
Check ChangelogCredits
Images
- Shutterstock
- Unsplash
- Picjumbo
- Flick CC
- Mazwai
- Photodune
- Pixabay
- Magdeleine
Mockups
- Graphic Burger
- Pixeden
- Creative Market
- PSD Covers
- Pixel Buddha
Javascript
- jQuery
- Awesomplete
- Twitter Bootstrap
- Tabler Admin
- Purple Free Admin Template
- Clipboard
- ImagesLoaded
- iziModal
- Tippy
- Toastr
CSS
- Animate.css
- Loaders.css
Fonts
- Google Fonts
- Font Awesome
- Feather
- Made Evolve Sans by MadeType
Miscellaneous
- GSAP
- Marketplace Template by NiceVeryNice.com
THANK YOU !!!
Thank you once again for purchasing our plugin and going through the documentation. We hope we have been useful towards your online endeavours. Feel free to contact us anytime on any matter. Also, let us know how we can improve our documentation.
With Warm Regards,
UI-CLAN