Introduction
Thank you for purchase!
This is documentation for "Herbalist - Medical Marijuana Store WordPress Theme". Documentation consists of sections. Every section explains specific part of theme or functionality. List of sections is in left side of screen.
- If you are new to WordPress, it is recommended to read official WordPress documentation first.
- Please read theme documentation and follow instructions for demo theme content setup.
- Use search (ctrl+f keyboard shortcut) to find words on page.
- If you have questions please send message here using account that you purchased theme with to confirm purchase.
- Before asking for support please read more about general support for themes and item support policy.
Demo theme content setup
Steps for demo theme content setup
1.Unzip main.zip file that you downloaded from Themeforest, find „herbalist.zip“ and upload it to WordPress dashboard.
2.
In WordPress dashboard go to appearance/themes and activate theme „Herbalist“.
3.
Install and activate all recommended and required theme’s plugins
4.
Go to Elementor/Tools/Import/Export kit and import elementor-kit.zip file for Elementor page builder custom styles. Elementor-kit.zip file is in folder "demo-content" inside main zip file you downloaded from Themeforest. Unzip it and find it.
5.
Go to tools/import and import demo xml files from "demo-content" folder. It is recommended to upload demo content in parts in case you have limit of 2MB for uploading files in dashboard. In that case, files that need to be uploaded: demo-pages.xml file, demo-posts.xml file, demo-navigation.xml file etc. In case you have higher limit of 2MG for uploading files in dashboard, it is possible to upload all demo content at once. All demo content is in file: demo-all.xml.
"Demo-content" folder is inside main zip file you downloaded from Themeforest. Unzip it and find it.
Be sure to replace demo images with your images or purchase license for demo images.
6.
Go to Dashboard/Smart Slider/New Project and upload demo sliders.
Demo sliders are in "demo content" folder in main folder.
There are:
1. Demo slider for homepage 1 - "slider product"
2. Demo slider for homepage 4 - "slider hero"
3. Demo slider for video homepage - "slider video".
7.
Go to appearance/menus and set demo content menu.
If you imported full demo content then you will already have "Menu 1" - theme demo menu (you can create new menus if needed). Check the location for it in "Display location". named "Desktop horizontal menu".
8.
Go to Customizer - appearance/customize/homepage settings and set static page (front page) for home page
Set other theme options as well. More about theme options you can read in section "theme options".
9.
Import theme demo widgets. Instal and activate this plugin: Widget importer & Exporter and import widgets.wie file. Widgets.wie file is in demo-content folder.
Basic installation is finished. For more details and functionalities please see sections list in left side of screen and continue reading.
Elementor page builder plugin
This theme is built with Elementor page builder plugin. Official plugin page Theme will add custom Elementor widgets.
Menus
Theme has 2 custom menu locations. "Desktop horizontal menu (default)" as main default menu and "Desktop horizontal menu second" as second menu location."Menu 1" imported with demo content is theme demo menu (you can add new menus if needed). Check it to appear in default menu location.
Mega menu
To get mega menu column, add class "mega-menu-column" to the top link menu under which mega menu should appear.
To get "CSS classes" option to appear in menu, follow this instruction:
- Go to admin / appearance / menu
- Click on Screen Options (top right of the screen)
- Check the CSS classes options in the "Show advanced menu properties" panel
Contact form
Everything related to contact is created with Contact form 7 plugin. Official plugin page. Contact forms are imported with demo content.1. This is code for "Contact form 1":
<label> Your name</label>
[text text-159 "your name..."]
<label> Your email</label>
[email* your-email "your email..."]
<label> Your message (optional)</label>
[textarea your-message "message..."]
[submit "Submit"]
2. This is code for "Subscribe form":
<div class="subscribe-custom1">[email email-806 "Search..."][submit "Submit"]</div>
Pages and page templates
Pages have 4 custom options:- Background image for page title. It works only for page templates that have main page headline
- Add transparent menu
- Add white text menu
- Change menu location on page
Customizer theme options
Theme options are in appearance/customize. Options for logo, sticky menu, background images, copyright, colors, menus etc.
Shortcodes
1. Custom shortcode for social icons:
[rtherbalist_socialicon icon="fa-brands fa-facebook-f" url="#"]
Add icon class from here: https://fontawesome.com/v6/search .
Widgets
- Widgets are default WordPress feature. To open widgets go to appearance/widgets in dashboard. Official WordPress documentation: https://codex.wordpress.org/WordPress_Widgets- Theme has widget areas that can be found in dashboard/appearance/widgets. In theme setup at top of the page is explained how to import demo widgets.
- This is code snippet for contact (on demo website - footer second)
<div style="margin-bottom: 19px;">[rtherbalist_listcontact text1="+1-202-555-0133" text2="+1-202-555-0133" icon="fa-solid fa-phone"]</div>
<div style="margin-bottom: 19px;">[rtherbalist_listcontact text1="192 North Border Street" text2="Lithonia, GA 30038" icon="fa-solid fa-map-marker"]</div>
[rtherbalist_listcontact text1="9:00 am to 5:00 pm" text2="Monday to Saturday" icon="fa-solid fa-clock"]
- This is code snippet for shop product shortcodes ("footer column 3" widget area)
[rtherbalist_listlink title="Flover"]
[rtherbalist_listlink title="Oils"]
[rtherbalist_listlink title="Edible"]
[rtherbalist_listlink title="Concentrates"]
[rtherbalist_listlink title="Shop all"]
Custom classes
Classes to be added to Elementor's column or section where widget appears to modify it's style. These classes are already in demo content.1. "video-button-hidden" - For video boxes.
2. "elementor-accordion-faq" for custom accordion (faq)
How to set permalinks
- Permalinks are in dashboard/settings/permalinks.- It is recommended to have this permalinks structure (see screenshot):
How to reset permalinks?
- Set permalinks to default (plain) and click button "save changes".
Plugins
Rt Herbalist Theme Functions plugin - theme functions and custom post types plugin, bundled with theme.TGM plugin bundled with theme. http://tgmpluginactivation.com/
Elementor page bulder plugin. https://wordpress.org/plugins/elementor/
Advanced custom fields plugin. https://wordpress.org/plugins/advanced-custom-fields/
Contact form 7 plugin. https://sr.wordpress.org/plugins/contact-form-7/
Breadcrumbs plugin. https://wordpress.org/plugins/breadcrumb-navxt/
For post's list widget, this plugin is recommended: Latests post plugin. https://wordpress.org/plugins/latest-posts/
WooCommerce plugin. https://wordpress.org/plugins/woocommerce/
Countdown Builder plugin. https://wordpress.org/plugins/countdown-builder/
Smart slider 3 plugin. https://wordpress.org/plugins/smart-slider-3/
Woo smart wishlist plugin. https://wordpress.org/plugins/woo-smart-wishlist/
Woo smart quick view plugin. https://wordpress.org/plugins/woo-smart-quick-view/
Woo fly cart plugin. https://wordpress.org/plugins/woo-fly-cart/
Woo product filter plugin. https://wordpress.org/plugins/woo-product-filter/
Menu image plugin. https://wordpress.org/plugins/menu-image/
Ever compare plugin. https://wordpress.org/plugins/ever-compare/
Child theme
- Basic child theme "herbalist-child.zip" for this theme is in main_file.zip.- Official WordPress documentation about Child themes: https://codex.wordpress.org/Child_Themes
- It is recommended to activate child theme if you make code customizations and to copy/paste all files from parent theme with code custom changes in child theme.
How to change color
Open "Global colors" settings in Customizer, be sure to choose "add" option and then change global theme colors. Colors are unlimited. It is recommended that the color that is added instead of default one has similar lightness and saturation to default color to better fit design.
How to change fonts
1. Fonts can be changed in child theme, requires basic coding knowledge.
2. Fonts in page builder elements should be changed in Elementor settings because theme uses custom Elementor kit with theme fonts.
3. Recommended plugin for global theme fonts:
https://wordpress.org/plugins/olympus-google-fonts/
Basic plugin settings can be used to change base and headline theme fonts. To return theme font's settings to default, set fonts back to default styles and deactivate plugin.
Theme translation
Theme has pot file included, that means text strings in dashboard can be translated. Activate translation plugin. Can use Polylang. https://wordpress.org/plugins/polylang/ Check if "languages" tab in settings appears. In theme folder "languages" default pot file is included. To translate text strings in theme, please rename herbalist.pot file to "language code" for language you want to translate in, for example if you translate to Portugales language code is "pt_BR" so herbalist.pot should be renamed to "pt_BR.po". Then open the file with Poedit and translate text strings. http://poedit.net/ More details about WordPress translation here :http://codex.wordpress.org/WordPress_in_Your_Language http://codex.wordpress.org/Installing_WordPress_in_Your_LanguageHow to reorder posts
- Install and activate this plugin: https://wordpress.org/plugins/post-types-order/- It adds "reorder posts" button for all posts and custom post types and you can manually reorder them.
SCSS file
If you are familiar with coding and need to make changes with SCSS file this plugin can be used: https://wordpress.org/plugins/happy-scss-compiler/. For small CSS changes and customization it is recommended to use CSS file in child theme.Favicon
Upload favicon in appearance/customize/site identity/site icon. Official documentation: https://codex.wordpress.org/Creating_a_FaviconSources and credits
TGM plugin activation https://github.com/thomasgriffin/TGM-Plugin-ActivationAll free plugin mentioned above from WordPress respository.
Bootstrap css framework,
Font Awesome font icons,
owl-carousel.js,
bootstrap.js,
Google fonts,
jQuery.js,
imagesloaded.js,
isotope.js,
magnific popup.js,
Demo images credit
Images are not included for download. Images are slightly transformed to fit design. Images and icons credit: http://flaticon.com/ , https://elements.envato.com/