Amara WordPress Documentation

Introduction

This document covers the installation and use of this template and often reveals answers to common problems and issues - we encourage you to read this document thoroughly if you need an in-depth guide on how to use the template.

If you have any questions that are beyond the scope of this document, feel free to ask via ticket support system: WarpTheme Ticket System

To get access to the ticket system, create an account on this page: Create an Account

Overview

Amara is a Responsive One Page WordPress Theme. A fresh, new, perfect to promote your work or your corporate, agency, nonprofit, freelancer or general business. Amara is a full Responsive WordPress Theme built with Elementor Page Builder & Warp Framework.

Home page

Sticky menu, Uikit components and Cookie Law

Block Appearance (PRO)

Built on Warp 7 Framework

Amara is built on a very robust framework to give you un-matched flexibility and speed when it comes to building the template layer of your site.

Warp 7 is a class of it’s own. Underneath the framework, it uses UIkit, a lightweight and modular front-end modular framework for developing fast and powerful web interfaces using the latest web technologies.

1. Responsive Design

A fully responsive layout that adapts perfectly for all device resolutions like mobiles, tablets and desktops.

All of the Warp templates are adaptable. Yep, just like this. From the box. This feature can be turned off, it also can be adjusted. See how easy you can customize adaptive widgets:

Responsive design

The user simply sets how a particular block should look on different devices. That’s all. Easy and convenient.

2. UiKit

UIkit – wonderful analogue of bootstrap. The latest version (Warp 7) has the latest version UIkit inside. A developer can easily run various functions and a user can easily use them.

3. Styles

It is important to know they are exist. There are multi styles also. A developer creates a template and a few basic styles. The user can easily change them, or create his own.

4. Layouts

Support multi Layouts. You can create an unlimited number of Layouts and combine them with an unlimited number of styles. It’s fantastic what can be done with just these two pieces: Styles and Layouts.

5. Sidebars

The sidebar management (not to be confused with the positions of the widgets, they are also often called Sidebars) is very simple and flexible.

Sidebar control

You can place on the left or put them on the right side. Their width and display are adjustable. Everything is sleek and simple.

6. Widgets

Unfortunately, there aren’t many opportunities to manage widgets on pure WordPress. You can either display them or hide. This is not enough. Fortunately, there is a huge amount of all sorts of plugins that solve this problem. Warp 7 offers a nice solution, built right into the template.

You don’t have to use 3-4 plugins for managing widgets anymore; everything can be done right from the template.You can manage the headers display for each widget separately, You can attach a widget to certain pages or categories, You can set the style of the widget, add a badge or icon, can manage its behavior if widget is responsive. Moreover, if this is not enough, You can prescribe for the widget class of its own, and stylize it individually. That’s great, isn’t it? You need only WordPress and Warp template to create anything you like.

Widgetkit Warp 7

7. Menus

Menu management – This is an important part of a website. Key part. Warp has a great tools menu management and its display. The user can customize the behavior of pop-up menu, add a subline to the items and icons. Just to bring a beauty. All of this we can do without any plugins. All of this is inside the template.

8. Compression

No matter how many icons you have added to styles, no matter how many scripts or how many LESS and CSS files. Template will compress all of this and produce a single file. Quickly. Nice. Google will appreciate this.

Warp Compression

9. Development

Warp has a well-considered architecture and logical structure so you can easily extend or modify the functionality.

10. Customizer

This in my opinion – a killer feature. It allows developers as well as users to create new styles for a template clearly in real time. You can see here.

Getting Started

When you purchase our Joomla! template or WordPress Theme, you'll then be taken to the Downloads page. Click on the "template/theme" file name to download or you can check back anytime by going to Purchase History page.

After downloading our product you’ll find the following files/folders within:

WordPress Theme Packages

amara_wp_pro_1.2.0.zip
The stand-alone Joomla! template installation package.
WT_Amara_Wordpress_Quickstart_1.2.0_Unzip.zip
A quick-launch WordPress installation package that contains all the sample data, images and most plugins to replicate the live demo.

Folder Structure

Template/Theme comprises of LESS, CSS, Javascript and PHP files that power the robust underlying Warp Framework. In this section, we are going to cover the css, LESS, js and php files to help you understand the template’s structure.

1. CSS Folder

This folder contains css files which render the front-end look and feel of the site. It contains four files:
FileDescription
bootstrap.css this file contains the css for bootstrap.
custom.css use this file to add your own custom.css.
ie9.css this file fixes issues related with Internet Explorer 9 browser.
theme.css this file contains the css for the template. It is compiled from less/theme.less.
Note You should never edit theme.css or bootstrap.css directly as they are automatically generated when you compile the LESS files. If you want to custom your css code, use custom.css to add your own css code.

2. Fonts Folder

This folder contains custom fonts files.

3. Html Folder

This folder contains the overrides for components and modules.

4. Images Folder

This folder contains the image files that have been used in the template.

5. js Folder

This folder contains the javascript files used in the template.

6. Layouts Folder

This folder contains the core files that render the front-end look of the template. The most important file in this folder is theme.php. To understand more about this file, please read this article: Layouts Folder.

7. Less Folder

This folder contains the less files which in turn, generate the css output files that are located in the css folder. The less files are:
FileDescription
less/theme.less Defines the theme style and imports the UIkit theme. This file will be compiled into CSS and saved in the /css folder everytime you hit Compile LESS in the theme settings.
style.less This file defines the unique less code for each style
customizer.json This file defines the customiser parameters that will be displayed in the live customizer.

8. Warp Folder

This folder contains the actual Warp 7 core framework.

Installation

This section covers how to install the template. There are two ways in which you can install the template:
Using Quickstart Package(recommended)
A demo package is a full WordPress installation, which includes the theme and sample data responsible for the layout and setup of our demo. This is great, if you don't want to start from scratch or just to have a peek at how everything is put together.
Single theme package
Installing the theme in an existing WordPress site.

If you are using Joomla Template or WordPress Theme from other Providers and want to switch to our templates/themes. We will help you config your existing site with our templates/themes. It FREE but for Customers who purchased Pro Unlimited Edition

Quickstart method


What is Quickstart?

Again, Quickstart package is a full website package that includes: themes, plugins, database, images ... and once you install the quickstart successfully, you will have a complete website that is exactly same as our Demo.

WordPress Quickstart Install Requirements

Before starting with the install it’s important that you ensure that your hosting covers the minimum requirements for WordPress 4.x(We highly recommend SiteGround to host your WordPress site), as the quickstart package for WarpTheme templates/themes will always include the latest compatible version of the CMS:

  • PHP 5.3.1 or higher – 5.4+ is recommended;
  • MySQL 5.1 (or higher) or PostgreSQL 8.3.x
  • Apache 2. x or higher
  • XML and Zlib support: Your host’s PHP installation should support XML and Zlib functionality.
  • PHP Magic Quotes GPC setting should be off. If this setting is currently on, your web host should be able to correct this.
  1. Upload the [template]_quickstart.zip to your server using your preferred FTP software and unpack the contents to your server. A good FTP that we use is Filezilla. In most cases you will unpack it under the public_html folder, www root folder (windows hosting) or the root folder of your server.
  2. Access your site on the browser e.g http://www.mysite.com/installer.php and this should direct you to the installation prompt of your WordPress! installation.
  3. Follow the WordPress! installation prompts, adding database, username and password for database.
  4. Once the installation is complete, delete the installation folder and your site should look exactly like the demo version.
Note Once this final step is complete you’ll have a fresh install of WordPress, along with the theme and all the settings and content needed to match the demo, including sample article content

Note If you have existing WordPress! website, you should install the THEME installation package instead quickstart package. Using quickstart package if you want to build the site both look and feel and content like our live demo.

Single theme method - for existing WordPress! installation.


If you have an existing WordPress! installation, these are the steps to follow:
  1. Log in to your WordPress! backend e.g. http://www.mysite.com/wp-admin and navigate to the Appearance -> Themes
  2. Click Add New -> Upload Theme -> choose theme package and select your [theme_name].zip theme package file. Click on "Install Now"
  3. Active the theme

Video Tutorials

Install Quickstart Package For WordPress:

Demo Pages

This section will help you understand about the Demo pages for Amara. How to design, reuse the content from quickstart package. Instead of starting from scratch, use our pre-designed pages to jumpstart your design process or get inspired.
We are using Elementor to build the pages for Amara. You can find documentation for Elementor page builder here: https://docs.elementor.com/

Editing Home page Amara

Log in wp admin then browser to Home page, you will see the button "Edit with Elementor" like this

Here you can add/remove any sections, widgets, changing the content to suite your needs.

Basic elementor for section editing can be found here https://docs.elementor.com/category/5-getting-started

Do the same for contact page

Template/Theme Configuration

Setup the logo

Setting up the logo in WordPress is pretty straightforward. Just add new widget image to logo widget position.

NOTE Warp 7 also provides the logo-small position, where you can display an alternative logo image for smaller viewport sizes. (mobile/tablet devices)

To add the small logo that appears on smaller device screens, do the following

Setup the menus for WORDPRESS

To tell your theme what should be rendered as your main navigation, we need to setup a menu in WordPress and assign it as our main navigation.

First of all, you need to create a new menu and add your menu items. For detailed instructions, see the WordPress documentation. In this example we add all existing pages by default and remove one that we do not want.

Create a menu

Now we just need to select the freshly created menu to be used as the main navigation on our site. Hit the Manage locations tab on the top and select the menu from the dropdown.

Assign menu to be used in the theme

Menu on small devices

The default menu will be hidden on small devices. You can and should use the offcanvas position to have a mobile friendly version of your menu. The offcanvas element can be toggled from a menu icon. You can also publish other widgets in this position, but a menu is the most likey thing you'll want in any case.

Use a custom menu to be displayed as an offcanvas menu

Menus in any position and menu styles

You can create any number of menus you like and publish them as a Custom Menu widget in the Widget area of the WordPress backend. You can assign that widget to any position you like.

There are three different menu styles, the Mega dropdown menu as a main menu, the Accordion menu in sidebars and the Line menu in the toolbar or footer. Warp automatically styles the menu according the position it is published in.

Search Box

Add a search from to Search Widget like so

Setting up Breadcrumbs

Add Warp-Breadcrumbs to breadcrumbs widget

Layout Settings

The layout settings manage the positioning of different layout parts.

This section makes the arrangement of your content very easy and flexible. You can enable or disable system output, define the layout of the theme's widget or module positions and select a style you created in the customizer. Additionally you have the possibility to store your modifications in a layout profile and assign it to different pages.

Style

This option enables you to assign a style to your layout. In addition with the customizer and the layout manager this makes styling your pages very flexible.

Content

This option allows you to hide the main system output. This is useful, if you want to position only widgets/modules on certain pages, without leaving redundant space.

Sidebars

The Warp framework provides the following layout options for the sidebars.

Setting Description
Width Choose from the provided percent values to set the sidebar width.
Alignment Define, whether the sidebar is published on the left or right side of the content.

The sidebar settings allow you to create a fully functional multi-column layout. The only requirement is to publish a widget or module on a sidebar position to display the selected alignment.

Grid

This table gives you an overview of the grid layout settings.

Setting Description
Layout Define, whether the widgets or modules are positioned side-by-side, stacked vertically or first doubled.
Responsive Define, on which devices the widgets or modules take up full width and stack vertically.
Divider Add a vertical divider between parallel or first doubled widgets/modules to separate them from each other.

For more information on widgets and modules, take a look at the Widgets/Modules tutorial.

Layout Manager

The layout manager allows you to create new layouts and assign them to different pages. Warp provides a default layout as a reference.

How to create a new layout?

To create a new layout, follow these steps:

  1. Hit Add and enter a name to create a layout.
  2. That's it! You can start customizing your layout.
  3. Finally, assign your layout to the appropriate pages within the scrollable box at the bottom of the layout setting page.

Important You can't assign two different layouts to one page.

Widget/Module Settings

Manage your WordPress widget and Joomla module styles and settings.

Widgets or modules can be displayed in different styles with additional icons and badges. In the Warp Widgets/Modules overview, widgets and modules are grouped according to the positions in which they are published. Additionally, you can filter them by keyword and positions to which they are assigned.

Settings

This table gives you an overview of all available widget/module options.

Setting Description
Class Allows you to add your own custom CSS classes.
Style Lets you choose a widget/module preset style from the select box.
Icon Allows you to select an icon from the icon preview. You can also enter a path to a custom image. In Joomla enter the full path, for example /images/MY-IMAGE.jpg. WordPress already looks into the /wp-content/uploads folder. So you only need your custom path, for example MY-IMAGE.jpg.
Badge Adds a badge to your widget/module. Type in the text for the badge and select a color.
Display Display or hide a widget/module on specific devices like desktops, tablets or phones.

Specific WordPress Settings

Setting Description
Title Displays or hides the widget or module title.
Assignment Defines, on which pages the widget/module should be displayed by assigning it to the pending menu item. You can select multiple items by holding Ctrl-Key while clicking.

Troubleshooting

How to update Warp Framework

Learn how to update your Warp theme without losing your customizations.

If a newer version of your theme or Warp is available, you will receive a notification in the theme settings. You can download the framework from Yoo or download it here

UPDATE WARP

  1. Create a copy of your theme's /warp folder. That way, you will have a backup in case the update fails.
  2. Download any Warp 7 theme and unzip the package.
  3. Copy the /warp folder from the theme and replace the one in your theme with this one.

How to update templates/themes

We update our templates regularly to bring you more features, and improved stability and performance. So it's strongly recommended for you to keep up to date with the latest version and update your template.

The file verification in the theme settings shows all modified and missing files in your theme to help you detect which files you have customized before you start updating. Changes in Warp's administration area will generate the config.json, which is not shown in the file verification. So be sure to have a backup of that file. To update your theme, do the follow these steps.
  • First of all, make a backup of all your customized theme files, so you can recover modifications at any time
  • Download the latest template/theme version via Member Area and extract the package to your Desktop.
  • Copy all files to /templates/THEME-NAME for Joomla or /wp-content/themes/THEME-NAME for WordPress and replace all files
  • Recover your modifications by merging your customized files with the new ones.
  • Open Warp's administration area and hit Compile LESS.

Note We strongly recommend to create a new style for all modifications(or custom css code via custom.css file) and make a backup before updating. That way all your changes will be kept when updating your original theme files by replacing them. Learn more here.

Installation issues

Learn how to handle PHP issues during the installation process.

Most of the time installation problems are due to limited resources, for example on shared hosting servers. Here's an overview of the PHP configuration settings you should check and increase, if needed.

You may need to allocate more resources for PHP by modifying the php.ini file directly. If this is not possible, you can try setting the PHP settings through a .htaccess file on your webserver. Though this also depends on your hosting server, if it allows the usage of .htaccess overrides.

File permission issues

Learn, how to handle file permission issues with your Warp theme.

There are two ways of accessing files when working with Joomla or WordPress: either directly via your webserver or through an FTP client. Different files and directories have permissions specifying who can read, write or access them. Sometimes the permission settings of your webserver and your FTP client can collide, so that when trying to install an extension from the backend you are suddenly confronted with messages, like JFolder::create: Could not create directory or Directory not writable: /administrator/templates/system/ or you may not be able to save theme settings.

Change file permissions

To resolve these issues, you need to change the permissions of the affected files or directories.

Using your FTP client

  1. Open your FTP client or, if you don't have any, download FileZilla and install it.
  2. Use your FTP client to login to your server and browse to your webroot directory.
  3. Right click on the directory on which you want to change the permissions and click File Permissions...
  4. The Change File Attributes dialog lets you check different options or type in a numeric value like 755. Make sure the Recurse into subdirectories option is checked. Then hit OK.

Note Always avoid 777 permissions. If your webserver has problems with the CHMOD 755, you can also try 775 and lastly 777 in this order.

Use a Joomla extension to access your webserver

Using an FTP client may also change file ownership to the FTP user of the files or directories you changed the permissions on. This may cause problems on some webservers. To avoid this, you can use a Joomla component like eXtplorer to update the permission through the Joomla administration.

  1. Download the Joomla component eXtplorer and install it. It allows you to edit, delete, copy, rename, archive and unpack files and directories directly on your webserver.
  2. Login to your Joomla administration, go to the eXtplorer component and browse to the directory on which you want to change the permissions.
  3. Right click on the directory and choose Change Rights.
  4. Check the options as shown below. Make sure the Recurse into subdirectories option is checked. Then hit the Save button.

Find out more about file permissions in the Joomla documentation.

WordPress

Check out the WordPress documentation for more information on file permissions.

How to change favicon for theme/template

Learn how to change the favicon icon for theme/template.

For Joomla!: Upload your favicon icon to joomla/templates/template_name/

For WordPress: Upload your favicon icon to wordpress/wp-content/themes/theme-name/

Live Customizer

Live Customizer - enables you to change most aspects of the template without having to write any line of CSS.

How to use the customizer

By default, the customizer shows only a selected number of variables. Theses variables are the most used in the theme. There are different customizer modes to determine, to what detail you want to customize your theme.

  1. Login to the site’s administrator backend, go to Extensions > Template Manager.
  2. Click the template to edit, then click on Options tab.
  3. On the Settings vertical tab click on the Customizer button > the live customizer will appear with the options on the left and the site on the right.
  4. To see more advanced options, check the Advanced Mode checkbox > you will see more options appearing. On some of the headings, you’ll notice a ‘more’ link that lets you expand the options further.
  5. Once you are done, click on save.
  6. If you messed up the settings and you’d like to revert to the original, you can click on reset.
Mode Description
Advanced mode Activating the advanced mode extends the default variables with additional developer variables, which are rarely adjusted.
More In Advanced mode you can see a (More) button next to groups which displays all variables. The @ symbol indicates variables that are defined through other variables.

Credits

This template uses the following images, javascript libraries, icons, plugins, modules, components, or other files as listed below. All the content relating to products, services and events are fictional and are designed to showcase a live site. All images, icons, and photos are copyrighted to their respective owners.
Filed under: WP Doc