Documentation

Getting started

General

First of all, thank you for purchasing Apeiron! Before you get started, please be sure to always search this Documentation that outline all kinds of good information and provide you with all the details you need to use Apeiron. This theme can only be used with WordPress and I assume that you already have WordPress installed and ready to go. If you do not, please follow this link to see how to install WordPress.

Requirements For Apeiron

To use Apeiron:

• Check to ensure that your web host has the minimum requirements to run WordPress
• Always make sure they are running the latest version of WordPress
• You can download the latest release of WordPress from official WordPress website
• Always create secure passwords FTP and Database

Recommended PHP Configuration Limits

Many issues you may run into such as: white screen, demo content fails when importing, empty page content and other similar issues are all related to low PHP configuration limits. The solution is to increase the PHP limits. You can do this on your own, or contact contact your web host and ask them to increase those limits to a minimum as follows:

• max_execution_time 180
• memory_limit 128M
• post_max_size 32M
• upload_max_filesize 32M

What you have purchased

The file you have downloaded contains several folders:

• Documentation (that contains this very page)
• Dummy Data, that contains:
  • apeiron_sample_content.xml the demo content taken from here: https://giogadesign.com/demo/apeiron/ 
  • apeiron_sample_widgets.wie that contains the info to import widgets as well, by using this plugin
  • home-slider.zip that contains the homepage slider you can see here: https://giogadesign.com/demo/apeiron/
• Languages that contains:
  • apeiron.pot , the file you need to translate the theme in your language using Poedit 
• Licensing
• WordPress Theme that contains:
  • a folder called "apeiron"  you can upload via FTP
  • and a ZIP file called "apeiron.zip"  you can upload from the WordPress backend
    

How to install the theme

You have two options to install the theme (read above where the files are located):

1. by using an FTP client (FileZilla, Dreamweaver, FireFTP or similar) upload the folder called "apeiron" to
   your_root / wp-content / themes
2. directly from the WordPress backend, go to "Appearance" → "Themes" → "Add new (theme)" and click the "Upload theme" button on the next page. With the browse button find the aforementioned "apeiron.zip" file, then click "Install now".

How to install plugins

Above the theme options panel you should see this message box:

That's the list of the required and recommended plugins. The required plugins provide a large part of the features of this theme.

The recommended plugins are not mandatory, you won't read warning messages or get blank pages without installing them, but they are necessary if you want to update the theme and import the demo content correctly. Otherwise you'll get some "failure" notices during the import process and your installation won't reflect the demo, just this.

Simply click the "Begin installing plugins" button then the "Install" button on each plugin to start installing them. After you’ve installed them, an "Activate" button will appear which you can click to start activating them.

If you want to import the demo content you see here, please skip the WooCommerce pages setup. Otherwise, if you don't want to replicate the demo, click the "Install WooCommerce Pages" button.

Theme initial setup

Update your permalink structure

Change the Thumbnail size

Setting up the Menu

Apeiron supports custom WordPress menus, with multiple levels of dropdown support for the main menu. There are 3 areas of the theme where you can assign a menu:

• the Primary Navigation, to which assign the menu of the main top navigation,
• the Side Navigation, to which assign the menu of the top side navigation and
• the Secondary Navigation, to which assign the menu of any footer navigation.

Each of these menu locations can have a custom menu assigned. Once a menu is created and assigned to the location, it will show up on the site. There are also several options to customize the menu. Please see below for how to create a new menu and the available menu styles.

Choose the Template

Apeiron includes several page templates to choose from, and you will need to choose the page template that suits your needs. For example, if you want a page without sidebar, then you would select the "Default No Sidebar" page template. All of this is done in the Pages section of your WordPress admin.

• Default Template – This is the Default page template that automatically has the sidebar with it.
• About – This is the About page template with team members and without the sidebar. Choose this template for your about page.
• Blog Masonry/Standard Sidebar/No Sidebar – These are the Blog pages template. You can choose between blog masonry or standard, with or without sidebars. Choose these templates for your blog page.
• Cart – This is the Cart page template that you should choose if you have an e-commerce website which uses WooCommerce plugin.
• Checkout – This is the Checkout page template that you should choose if you have an e-commerce website which uses WooCommerce plugin.
• Contacts – This is the Contacts page template that you should choose when you make your contact page with Google Map & a contact form.
• My Account – This is the My Account page template to display user informations like billing and shipping addresses and that you should choose if you have an e-commerce website which uses WooCommerce plugin.
• Portfolio – This is the Portfolio page template to display portfolio items with masonry style.
• Portfolio_Ncol_styleN – These are the Portfolio page templates to display portfolio items with 2, 3 or 4 columns and different styles. See the demo for choose your style.
• Shop Masonry – This is the main Shop page without sidebar, you should choose it if you have an e-commerce website which uses WooCommerce plugin.
• WooCommerce – This is the main Shop page with sidebar, you should choose it if you have an e-commerce website which uses WooCommerce plugin.
• bbPress – This is the bbPress page to display forum pages, you should choose it if you use bbPress plugin.

Theme Customization

Apeiron customizer overview

With Apeiron Extended Theme Customizer you can choose from tons of options (Colors, Google-Fonts, Layouts etc.) to define the look of your site and preview changes in real time.

To begin your site customization, from the WordPress backend:

• go to "Appearance" → "Customize"
• in the customizer left sidebar choose the tab option you want to edit and when you're done making changes, click on the "Save & Publish" button at top.
• You can choose between the following options:
  • Logo
  • Site Title & Tagline
  • Display Options
  • Colors
  • Header Image
  • Background Image
  • Google Fonts
  • Navigation
  • Widgets
  • Static Front Page
  • Custom Content

If you make changes to the theme’s files (i.e. anything within the “/themes/apeiron/” directory), those changes are likely to be overwritten when you next update the theme. A child theme allows you to set up a standalone directory in which you can make create copies of the theme’s files and tweak away, without fear of your work being overwritten by any future updates.

If you don’t know how to create a child theme, please follow this link.

Upload your logo

From the "Logo" section of Apeiron theme customizer you can upload a custom logo that will be visible on your main navigation.

If you do not upload a logo, the site title will be displayed instead.

Apeiron theme is retina ready. You can also upload a logo that will be visible only on retina devices instead of the default non retina logo.

Remember that the retina logo you'll upload needs to be exactly twice the size of the regular logo. For example, if the standard logo is 190x50 px, the retina logo should be 380x100 px.

Choose menu styles

With Apeiron you can choose between 2 different widgetized menu: a side menu and a top menu. After you have set up the menu, as explained above, you need to follow these steps:

1. from the WordPress backend go to "Appearance" → "Customise"
2. open the "Display Options" tab, choose the menu style that will be displayed as main navigation at the top of your page and then click the "Save & Publish" button.

Some examples of the menu variations are shown below.

Important:

if you want to display correctly the Standard Top Menu , without the widgets areas and the customizations inside of it, you need to deactivate the Max Mega Menu Plugin. To do that, from the WordPress backend, go to "Plugins" → "Installed Plugins" and click the deactivate link below the Max Mega Menu Plugin.

If you want to use the Top Mega Menu, with the widgets areas and the customizations inside of it, you need to activate the Max Mega Menu Plugin. To do that, from the WordPress backend, go to "Plugins" → "Installed Plugins" and click the activate link below the Max Mega Menu Plugin.

To replicate the Mega Menu you see in the demo, after you have installed and activated Max Mega Menu Plugin, you need to change some parameters in the plugin page.

To do that:

• Navigate to "Appearance" → "Max Mega Menu" section of your admin sidebar.
• Copy the settings you see in the screenshot below then click the "Save Changes" button.

• Go to the "Theme Editor" tab
• Click "create a new theme" link
• Copy the settings you see in the screenshot below then click the "Save Changes" button.

• Navigate to "Appearance" → "Menus" section of your admin sidebar.
• In the "Mega Menu Settings" tab, select the checkbox to enable the megamenu, assign the menu to the theme you have created before then click the "Save" button.

Wide or boxed layout

From the "Display Options" section of Apeiron theme customizer you can choose between wide or boxed layout.

With "boxed" layout you can set a background image which will be visible on the right and left borders of your site. To upload your custom background image, go to the "Background Image" section of Apeiron theme customizer.

With "wide" layout, the right and left borders of your site will have the same color of your background.

Change colors

Change Main Text Color

To change main text color, go to the "Display Options" section of Apeiron theme customizer and select "Normal" if you have a light background color and you want a black text color or "Inverse" if you want white text color on dark background color.

Change Link Color

To change link color, go to the "Colors" section of Apeiron theme customizer and select your desired color through the picker.

Change Other Colors

To change Header Text / Background / Pre Footer Background and Footer Background Colors, as for link color, go to the "Colors" section of Apeiron theme customizer and select your desired color through the picker.

Change header image

To change the Header Image which will be displayed on the header section of your homepage, go to the "Header Image" tab of Apeiron theme customizer and upload or select your desired image.

Change font

To edit the Fonts of your site, go to the "Google Fonts" tab of Apeiron theme customizer, check the boxes and begin typing the font family you want to use.

Change footer text

To change the text displayed in footer, go to the "Custom Content" tab of Apeiron theme customizer, and type your custom text into the "Footer Text" section.

Widgets and Sidebars

All widgets are accessed in the "Widgets" section of the WordPress admin. Widgets can be added to any sidebar.

There are various fields and settings to choose for each individual widget; all are self explanatory.

You can put as many widgets as you want inside of a sidebar.

See the screenshot below to choose the right sidebar position for your widgets.

Premium Plugins

Purchasing Apeiron you save $58,00, the value of premium plugins included with the theme (Slider Revolution and Shortcode Ultimate Addons). You can also use the shortcodes generated by these plugins in any widget area within the sidebars.

Slider Revolution

If you have any questions about Slider Revolution plugin, please check its documentation.

Apeiron Theme uses Lazy Load effect to make the page load faster and to reduce server load.

To properly display the sliders, from WordPress backend, go to "Revolution Slider", "Settings" and in the "General Settings" tab select Lazy Load "ON".

Shortcodes Ultimate Addons

With Shortcodes Ultimate Addons you can choose from 40+ professional looking shortcodes and create unlimited buttons, galleries, tabs, accordions, spoilers, columns, headings, lists, boxes, quotes, pullquotes and much, much more with just a few clicks. All shortcodes are divided into groups for easier access.

You can also create your personal shortcode and insert it into posts, pages or widgets areas.

Import Demo Content

Import process

When you first install Apeiron theme, it will not contain all the extra content that you might have seen in the live demo. To import the Apeiron Demo Content you need to follow these steps:

• if you have installed BuddyPress, from the WordPress backend go to "Pages" → "All Pages" and delete the pages called Activity and Members
• delete all widgets inside the sidebars
• upload the file apeiron_sample_content.xml contained in the folder called "Dummy Data". To do that, in the WordPress backend, go to "Tools" → "Import"
• choose "WordPress" from the importer system list,

• select the file you want to import (apeiron_sample_content.xml)
• click the "Upload file and import " button
• import or assign author
• if you want to import the file attachments you see in the demo, check the "Download and import file attachments" box then click the "Submit" button.

To import the demo widgets, from the WordPress backend, go to "Tools" → "Widget Importer & Exporter" and into the "Import Widgets" section upload the file called apeiron_sample_widgets.wie.

To import the demo homepage slider, from the WordPress backend, go to "Revolution Slider", click the "Import Slider" button and upload the file called home-slider.zip.

Update theme and plugins

Update process

You can update the theme by activating a different theme for a while, deleting Apeiron from the theme list and upload it again via the WordPress backend or you can upload a new version via FTP and override all the old files.

Support

How to get support

Apeiron provides a 100% Free Support to answer your questions and collect your suggestions for future updates and improvements. If you have questions or suggestion about Apeiron, please use the comments section on theme page. I'll reply as soon as possible.

Before submitting a question, please remember to check this documentation. Maybe the answer you're looking for is here.