Mirasat - Like Themes WordPress Theme Documentation 1.0

1. Theme Support and Licence

Thank you for purchasing Mirasat WordPress Theme. If you need support you can contact us by email (like.themes.wp@gmail.com). You must provide purchase code, we'll answer you in 1-2 business days (if you wait for answer too long, please check spam folder). According to item support policy it doesn't include theme customization, third party plugins integration and hosting problems.

With ThemeForest Regular License you allowed:

• You are licensed to use the Item to create one single End Product for yourself or for one client (a “single application”), and the End Product can be distributed for Free
• You can modify the Item and therefore delete unwanted components before creating your single End Product

You are not allowed:

• You can’t Sell the End Product, except to one client. (If you or your client want to Sell the End Product, you will need the Extended License.)

For more information about license please read https://themeforest.net/licenses/faq.

2. Theme installation

Requirements

You need web hosting with at least PHP7.4, MySQL 5 or higher and WordPress 6.3 installed. Please check WordPress official minimal requirements https://wordpress.org/about/requirements/
If you have troubles with theme installation or one click demo install, make sure your server configuration limits are:

• post_max_size 32M
• upload_max_filesize 32M
• max_execution_time 600
• memory_limit 256M

You can check the server settings using the Custom PHP Settings plugin. Go to menu Tools > Custom PHP Settings > Settings

To change these values:

1. Edit your .htaccess file (at root of your FTP) and adding these lines:

php_value upload_max_filesize 32M

php_value post_max_size 32M

php_value memory_limit 256M

php_value max_execution_time 600

 
  2. Try to use plugin Custom PHP Settings. Go to menu Tools > Custom PHP Settings > General and paste the following strings into the text field:        
            post_max_size=32M
            upload_max_filesize=32M
            max_execution_time=600
            memory_limit=256M 

   3. If it still not helps - contact your hosting provider, they must help you with server configuration.

Installation

Please watch full video tutorial. It was recorded for our Autema theme, but can be used for any theme of our development.

1. FTP
   Upload the non-zipped theme folder into the /wp-content/themes/ folder on your server. You must upload folder /mirasat/ from archive mirasat.zip.
   
2. WordPress
   Navigate to "Appearance" > "Add New Themes" -> "Upload Theme" -> "Choose file" (choose mirasat.zip) > Install

Activate it after install!

Basic configuration

1. Install all required plugins by clicking on Begin installing plugins
2. Activate them after that
3. Update permalinks for custom pages in Settings -> Permalink -> Save

Attention! LT-Core, LT-Ext and WPbakery Page Builder plugins are responsible for the performance of the theme. They are required to install!
Notice: if you want to use a child-theme, you can also upload the file mirasat-child.zip in addition with the main Mirasat Theme. Child Theme allows you to add/modify CSS Stylesheet and functions without modifying main theme files. And you'll not lose your modifications after main theme update.

Demo Content Install

We recommend you to install demo content. Go to the Tools -> Demo Content Install. Be aware - installing of demo content will delete all your current content.
Click Install, wait till it'll be downloaded. Your WordPress Mirasat theme now must be identical to live preview. If you have troubles with installation, please check minimal PHP hosting requirements from Theme installation section.

3. Troubleshooting guide

Theme is missing the style.css stylesheet error

If you have error "Theme is missing the style.css stylesheet error" - make sure you uploading inner WordPress .zip file with theme, not the whole archive downloaded from ThemeForest. Unzip the archive and download only the attached *.zip file with the theme.

More information on https://help.market.envato.com/hc/en-us/articles/202821510-Theme-is-missing-the-style-css-stylesheet-error.

LiteSpeed web server

If backup or import interrupts with "Abort" link and you have this notice in dashboard “LT-Core: Your website is hosted using the LiteSpeed web server. Please consult this article if you have problems backing up.”

In this case you can use the solution that our developers found. You need to make changes to the file .htaccess and wp-config.php which are located in the root folder on your FTP server:

1) .htaccess:

RewriteRule .* - [E=noabort:1]

2) wp-config.php:

define('DISABLE_WP_CRON', true);

define('ALTERNATE_WP_CRON', true);

Menu assignment

Image regeneration

Requests made through the contact form do not come to the email.

4. Theme Configuration

Header Configuration

> Theme Settings > General > Logo and Media

Logo - allows you to upload your logo.
Default Heading Icon and Headings Icon white - sets image visible under two-line headings in theme
Menu pattern - animated (by default) icon for hover and active menu elements. You can find in media archive several colors. It will be also used for Go Top link at the footer
Inner Header and 404 Page Background - upload background images for certain pages.

Menu Like Themes > Theme Settings > Header > Navbar

Navbar Mobile Breakpoint, px - You can specify the point at which the navbar will switch to the mobile display. Important! The value must be specified in pixels.

Menu Like Themes > Theme Settings > Header > Topbar

Important! In this menu you can change only the visibility of the navbar and define it. You can create or edit the topbar in the menu Sections.

Menu Like Themes > Theme Settings > Header > Icons and Elements

In this menu you can assign different types of icons for display in the Navbar. For example: shopping cart, user profile, search, social network. You can also determine the display of icons on your mobile phone.

All icons created in this menu can be displayed in the topbar by adding a shortcode [ltx-navbar-icons] to the Raw HTML block. In the screenshot section topbar with this shortcode.
 

Menu Like Themes > Theme Settings > Header > Page Header H1
In this menu you can customize the background and effect of parallax.

"Page Header H1" responsible for the section of the site between the Navbar and the rest of the site content. See the screenshot below.

Footer Configuration

Menu Like Themes > Theme Settings > Footer > Widgets
In this menu, you can customize the display of content in the footer.

In the "Footer Default Style" drop-down list, you can choose three options for displaying the footer:

Default - displays footer with settings made in this menu.
Copyright Only and Copyright Transparent - hide all footer content and display only block Copyrights.

Also in this menu you can change Footer Background and enable Footer Parallax effect.

Widgets visibility.
In this part of the settings, you can configure the space to display content in the footer. The space of the footer on the screen is divided into equal parts depending on the active sections. For example: If you have all 4 footers turned on to display, then each of them will occupy a quarter of the screen. You can also hide the content of the footer for display on different devices by activating or turning off the footer with the desired number.
You can change the content in the footer in the menu Appearance > Theme Settings > Widgets.

Menu Like Themes > Theme Settings > Footer > Subscribe and Other
This menu determines the display of the subscription section above the footer. You can customize the subscription form in the menu Sections.

Menu Like Themes > Theme Settings > Footer > Go Top

In this menu we define the appearance and behavior of the "Go Top" button.

The button on the site looks like in the screenshot:

Menu Like Themes > Theme Settings > Footer > Copyrights

In this menu you can register your copyright.
Important! If you just leave the text input field empty, it will not remove our copyright from your site. You need to replace them with your own.

Posts Layout

In the menu Like Themes > Theme Settings > Posts Layout you can customize the display of content on pages with blogs, services, in the gallery and on WooCommerce pages. For example: enable or disable the sidebar in blogs or on the WooCommerce pages, change the number of products in one row per page, change the number of columns in the gallery... Excerpt Blog and WooCommerce - automatically cuts text on these pages.

Favicon

Color Customization

CSS Customization

• http://www.w3schools.com/css/
  
• https://developer.mozilla.org/en-US/docs/Learn/CSS

Also you'll need in-browser tool for CSS Tweaks (watch firebug video tutorial):

• Firebug (in Firefox)
• Chrome Developer Tools (in Google Chrome)
• Web Inspector (in Safari)

WordPress settings

1. Settings -> General. You can set here your email, timezone, date format
2. Settings -> Reading. Frontpage must be set to "Homepage", but you can use any page of site as welcome page. Also you can change number of posts per page. 6, 8 or 10 will be optimal
3. Settings -> Discussion. You can enable/disabled premoderation of comments here.
   

5. Menu and Widgets

Menu

Widgets

You can add the required widget to the footer using the drag and drop method. Or you can click on the widget and select where to add it in the drop-down list.

After adding the widget its contents can be edited as you need.

Important! Sidebar Default can be displayed on different pages of the site except WooCommerce pages. On WooCommerce pages only Sidebar WooCommerce is displayed. Footer 1, Footer 2, Footer 3 and Footer 4 are displayed only in the footer.

6. Posts

Blogs posts

It's standard WordPress posts module. You can write articles here, create categories, set tags.

Gallery

Among standard gallery, you can use our posts type. Main Photo with header and description will be shown in list and other photos with full-page zoom inside of gallery.

Testimonials

You can post clients feedback here, it will be available on /testimonials/ page. Also you can post preview of feedbacks on any page with shortcode.

Sections

Allows to edit common used on all pages blocks.

7. Pages

Among posts, pages are main module where you'll create your site content. You can use WPbakery Page Builder for visually change blocks and using shortcodes. You'll find information about all Mirasat shortcodes in next section, here we'll describe main editor functions.

To enable WPbakery Page Builder select Backend or Frontend editor. In most cases you need only Backend.

Layout

For every page you can configure:

• Navbar. Setting mostly used for HomePages to set different Navbars
• Subscribe. Can be hidden or visible. And changed in Sections Menu.
• Sidebar. Can be hidden or placed to left or right of page.
• Blog Layout / Gallery Layout. Different number of columns can be set. In order to show these pages correctly you must also set template.

8. Shortcodes

Here we describe our shortcodes:

Gallery Shortcode

The shortcode displays on the photo page from the specified gallery. In the settings it is possible to specify the time for autoscrolling.

Alert shortcode

You can create Warning Block:

In the shortcode settings, you can select 4 message types: Error, Success, Important and Warning. You can also change the shortcode icon and add your own warning text.

Zoom Slider shortcode

In the shortcode settings, you can specify the category in which the sliders are located and adjust the transition effects of the sliders.

This shortcode displays sliders from a specific category. You can add sliders and assign a category to them in the Sliders menu.

Services shortcode

Shortcode displays previously created services.
In the shortcode settings you can specify the category of services to display, the total number of services to display, the text of the label on the button and specify the period for autoscrolling.

Social Icons shortcode

Shortcode that displays social icons on the page. In the settings you can customize the appearance of the block, upload your own icons, add a link to the social network.

Header shortcode

Designed to display two sections of text: Header and Subheader. Provides a wide range of settings for each section individually.

Use Google Fonts to set unique header:

Content Width shortcode

Shortcode to display an adaptive block.

A text editor is built into the shortcode settings. It is also possible to add animation for text from a wide selection of templates.

Block with Icons shortcode

Create different information block with icons:

In the shortcode settings, you can add the required number of icons, specify a title for them and a text description.

Set all params and create Icons list. You can choose from Font Awesome library or upload you own icon.

Button Shortcode

Shortcode displays a button on the page. In the settings, you can add an icon for the button, change the text of the label, add a target link and make small appearance settings: select default color state, hover color state, different text color.
Position allows you to set several button in one row.

Partners Shortcode

Shortcode displays the photo and the name of the partner. You can also add a link to a partners website.

Google Map Styled Shortcode

The shortcode displays a Google map on the page and marks the coordinates specified in the settings.

Contact Form 7 Customized Shortcode

Important: Contact Form 7 plugin is a third-party plugin. Detailed documentation on how to configure this plugin here:
https://contactform7.com/setting-up-mail/

Blog

Insert block with last Blog Posts from archive

You can inset certain Blog Posts by ID's, or latest posts from Category. Also you can set needed text size.

CountUp Shortcode

CountUp Block is simple, but effective way to show some important information to you client.

Add several blocks, insert you information and that's all - animated block is ready.

Empty Space Responsive

Empty space is main tool to control your sections. You can create block of certain height, that will be transformed in mobile and tablet.

Video Popup

Products

Show latest product from WooCommerce plugin with filter and slider:

Tariff

This shortcode helps to visualize the difference between different tariff plans.

9. Forms

To add forms on your pages, first create them in required plugin. Then go to Contact -> Contact Forms

To insert form into page use CF7 Shortcode or CF7 Customized for more options.

10. Additional Plugins

WooCommerce

E-commerce plugin with huge amount of add-ons

Breadcrumb NavXT

Used for showing breadcrumbs in header of site

Post Views Counter

Show number of views in gallery and blog posts. If you disable it icon will be hidden.

MailChimp

11. Backup

You can backup your site in Tools -> Archives menu. Also you can enable Backup Schedule for automatic backup.

We strongly recommend you to do manual backups regularly, especially when you making updates or major changes on your pages.

12. Site Translation

To translate such strings we recommend using the Loco Translate plugin.

Install and activate the Loco Tranlate plugin

https://wordpress.org/plugins/loco-translate/

And then add it through the menu: Plugins > Add new > Upload Plugin.

13. WordPress Optimization

Very often there is a need to increase the speed of the site. The easiest way is to use optimizing plugins. Our team recommends using Autoptimize and WP Super Cache plugins.
You can check pagespeed of your site here: https://gtmetrix.com/
Also you can check this article about Wordpress optimization: https://gtmetrix.com/wordpress-optimization-guide.html

Autoptimize Plugin.

Link to the official page of the plugin: https://wordpress.org/plugins/autoptimize/

We use such plugin settings:

WP Super Cache plugin.

Link to the official page of the plugin: https://wordpress.org/plugins/wp-super-cache/
We use such plugin settings:

A3. Site migration

As a rule, during development, no one wants outsiders to see his site, so development is carried out on a local server, or on a test domain, or a stub is put on the site. In the first two cases, after the project is completed, it will need to be transferred to another hosting and another domain. In this article, we will consider a simple way to transfer a site from one hosting to another.

Important: hosting must meet the minimum requirements of Wordpress and the Domain must be configured.
The requirements of the WordPress engine can be checked at the link below:
https://wordpress.org/about/requirements/

For site migration we use the Duplicator plugin. Below is a link to it:
https://wordpress.org/plugins/duplicator/

After installing the plugin, you will have access but this menu:


In the "packages" menu, you can create a new package for migration or view old versions of packages. Let's create a new package.


The first step of the plugin:


Second phase:


The third stage: download the archive with content and the installer.


Copy the archive with the content and the installer to the root folder on your new hosting. To start the installation, enter this text string in the address bar: YourDomainName/installer.php, аnd follow the instructions.

First step:


Second phase. Database connection.:


Third stage:


At the fourth stage, you will be prompted to enter the site and automatically remove the transfer packets.

A4. Theme Updating

Content Backup

Updating of the theme does not delete any content you have, but we still strongly recommend you to make  a content backup. The regular backup is also recommended before updating any plugins. The backup can be done using the built-in tool:

Tools -> Backup -> Create Content Backup

In case you have issues with using built-in method you can try to use additional plugins:
https://wordpress.org/plugins/search/backup/

All these measures required only for critical errors and we never encountered such a situation, but making a backup before any major update is always a good idea.

Theme Backup

Envato Market Theme Update

The most easy way to update the theme is using the Envato Market plugin. All our themes include it:
https://envato.com/market-plugin/

It has detailed instruction in Help Tab and you need to connect your site with Envato Account using the Envato token:

After theme update you also may need to check Plugins menu and make sure all theme required plugins are also up to date,
especially LT-Ext or LTE-Ext. In case an update required you will be asked to do it.

Manual Theme Update

In case you do not want to update the theme using the Envato Market plugin, you can use a manual method.

• Download the latest theme archive from the ThemeForest:
  
• Go to the Appearance -> Themes and manually switch to the default WordPress theme Twenty Nineteen. If the theme does not exist you can temporarily add it using the Add New button at the top.
  
  After switching to the default theme you can delete the old version of original parent theme by clicking on it and choosing Delete.
  Please note, that you do not need to delete or modify child theme and only parent theme requires update.
  
  
• Use the Add New button and install the downloaded archive from the ThemeForest and activate it.

This method also does not delete any content data you have, but as always we recommend you to create a backup before.

FTP Theme Update

If you are familiar with FTP client the updating process can be easily done by uploading unpacked theme files to the /wp-content/themes/your-theme/ and replacing old ones:



This method updates the whole theme without affecting your content and copying of old theme files before update is also strongly recommended.

After Theme Update

All your content is stored in a database and theme update only changes files of the theme. But we still recommend to check these possible issues after the theme or plugins update:

• Make sure your Navbar has all menu items and the mobile menu also works correctly. Sometimes changing or updating the theme can reset menu assignment. In this case you can go to the Appearance -> Menus and activate the Main Menu box at the bottom of required menu:
  
  
  
• Check the blogs, WooCommerce shop and footer widgets. In case something wrong you can reassign them at the Appearance -> Widgets
• Check all primary site pages and if you have e-commerce site check the WooCommerce shop functionality, especially after WooCommerce plugin update

http://like-themes.com