DOCUMENTATION


Thank you for downloading this theme. We appreciate the trust you have given us, and so we made this documentation as clear as possible, so that no one will encounter any problem. If you can't find what are you looking for in the documentation or FAQ section, feel free to contact us. We are happy to help you with every problem you may encounter.

Installation

Theme Archive

After you have purchased the theme, the archive downloaded from Themeforest will look something like this:
The theme itself is located in neori folder. The installable .zip archive is the one called neori.zip

Installation via WP

Login to your WordPress Dashboard (your-site.com/wp-admin/), and then navigate to Appearance > Themes.
Then click on the Add New button.

A new page will open. Click on the Upload Theme button.

Press the Choose File button.

A dialog box will show up, asking you to add a .zip archive.

ATTENTION: A common mistake that users make at this point, is that they try to upload the .zip archive with all the files that they have downloaded from Themeforest. You must upload the .zip archive with only the theme itself, not the .zip archive with all files.

In order for this not to happen, be sure you have downloaded the Installable file only from Themeforest.

That's the .zip you must upload.

The theme will now upload. After the upload is done, you need to click on Activate.

That's it. You're done.

Installation via FTP

Sometimes because of the quality of hosting providers or diffrent aspects that may occur, WordPress native theme uploader may not work. In this case, you have to upload the theme via FTP.

To do that, open your FTP client, login, and navigate to public_html/wp-content/themes

Then, extract here the folder named "neori" from the neori.zip archive you've downloaded from ThemeForest.

Now that the theme is uploaded, you just need to activate it from the WordPress Dashboard.

To do that, login into your WordPress Dashboard, and go to Appearance > Themes.

You should see Neori theme listed there. Click Activate.

That's it. The theme is now activated and ready to use.

Required Plugins

As soon as you install the theme you will be prompted with a message as follows:

This is because this theme requires and recommends a series of plugin in order to work correctly.

  • Neori Shortcodes is a required plugin that allows the usage of shortcodes in order to display the Slices.
  • Vafpress Post Formats UI is a required plugin that allows this theme to display the Posts Formats in a better way.
  • Contact Form 7 is a recommended plugin that is responsible for the contact form.
  • Neori Social Share Buttons is a recommended plugin that is responsible for the social share buttons that are placed at the beginning and at the end of the post. If you don't want to use this plugin, you are free to use any other social plugin you preffer.
  • Sticky Menu (or Anything!) on Scroll is a recommended plugin that allows you to make the Sidebar sticky on scrolling as presented in the demo.
  • Yellow Pencil is a recommended plugin that allows you to customize every possible element on the site, with a front-end visual editor.

In order to install this plugins, you have to click on Begin installing plugins.

After the plugins are installed succesfully, click on Return to Required Plugins Installer.

There, select all of them, select Activate and then click on Apply button.

That's it, now all the plugins are activated.

Theme Structure

  neori.zip
  ├── css
  │   ├── bootstrap.min.css
  │   ├── bootstrap.min.css.map
  │   ├── font-awesome.min.css
  │   ├── modified-bootstrap.css
  │   └── simple-line-icons.css
  ├── fonts
  │   ├── fontawesome-webfont.eot
  │   ├── fontawesome-webfont.svg
  │   ├── fontawesome-webfont.ttf
  │   ├── fontawesome-webfont.woff
  │   ├── fontawesome-webfont.woff2
  │   ├── FontAwesome.otf
  │   ├── Simple-Line-Icons.eot
  │   ├── Simple-Line-Icons.svg
  │   ├── Simple-Line-Icons.ttf
  │   ├── Simple-Line-Icons.woff
  │   └── Simple-Line-Icons.woff2
  ├── img
  │   ├── logo-small.png
  │   ├── logo.png
  │   ├── search-icon-black.svg
  │   └── search-icon.svg
  ├── inc
  │   ├── customizer.php
  │   ├── jetpack.php
  │   ├── recent-posts-widget.php
  │   └── responsive-banner-widget.php
  ├── js
  │   ├── bootstrap.min.js
  │   ├── bootstrap.min.js.map
  │   ├── customizer.js
  │   ├── neori-general-scripts.js
  │   ├── popper.min.js
  │   └── popper.min.js.map
  ├── languages
  │   └── neori.pot
  ├── plugins
  │   ├── neori-shortcodes.zip
  │   ├── neori-social-share-buttons.zip
  │   └── waspthemes-yellow-pencil.zip
  ├── template-parts
  │   ├── headers
  │   │   ├── header-ad.php
  │   │   ├── header-centered.php
  │   │   └── header-normal.php
  │   ├── page
  │   │   ├── content-page-default-sl.php
  │   │   ├── content-page-default-sr.php
  │   │   ├── content-page-notitle-sl.php
  │   │   ├── content-page-notitle-sr.php
  │   │   ├── content-page-notitle.php
  │   │   └── content-page.php
  │   ├── single
  │   │   ├── content-single-classic-boxed-gallery.php
  │   │   ├── content-single-classic-boxed-ns-gallery.php
  │   │   ├── content-single-classic-boxed-ns-video.php
  │   │   ├── content-single-classic-boxed-ns.php
  │   │   ├── content-single-classic-boxed-sl-gallery.php
  │   │   ├── content-single-classic-boxed-sl-video.php
  │   │   ├── content-single-classic-boxed-sl.php
  │   │   ├── content-single-classic-boxed-video.php
  │   │   ├── content-single-classic-boxed.php
  │   │   ├── content-single-classic-fullwidth-gallery.php
  │   │   ├── content-single-classic-fullwidth-ns-gallery.php
  │   │   ├── content-single-classic-fullwidth-ns-video.php
  │   │   ├── content-single-classic-fullwidth-ns.php
  │   │   ├── content-single-classic-fullwidth-sl-gallery.php
  │   │   ├── content-single-classic-fullwidth-sl-video.php
  │   │   ├── content-single-classic-fullwidth-sl.php
  │   │   ├── content-single-classic-fullwidth-video.php
  │   │   ├── content-single-classic-fullwidth.php
  │   │   ├── content-single-classic-gallery.php
  │   │   ├── content-single-classic-ns-gallery.php
  │   │   ├── content-single-classic-ns-video.php
  │   │   ├── content-single-classic-ns.php
  │   │   ├── content-single-classic-sl-gallery.php
  │   │   ├── content-single-classic-sl-video.php
  │   │   ├── content-single-classic-sl.php
  │   │   ├── content-single-classic-video.php
  │   │   ├── content-single-classic.php
  │   │   ├── content-single-default-boxed-gallery.php
  │   │   ├── content-single-default-boxed-ns-gallery.php
  │   │   ├── content-single-default-boxed-ns-video.php
  │   │   ├── content-single-default-boxed-ns.php
  │   │   ├── content-single-default-boxed-sl-gallery.php
  │   │   ├── content-single-default-boxed-sl-video.php
  │   │   ├── content-single-default-boxed-sl.php
  │   │   ├── content-single-default-boxed-video.php
  │   │   ├── content-single-default-boxed.php
  │   │   ├── content-single-default-ns-gallery.php
  │   │   ├── content-single-default-ns-video.php
  │   │   ├── content-single-default-ns.php
  │   │   ├── content-single-default-sl-gallery.php
  │   │   ├── content-single-default-sl-video.php
  │   │   ├── content-single-default-sl.php
  │   │   ├── content-single-gallery.php
  │   │   ├── content-single-video.php
  │   │   └── content-single.php
  │   ├── slices
  │   │   ├── content-type1.php
  │   │   ├── content-type2.php
  │   │   ├── content-type3-1.php
  │   │   ├── content-type3-2.php
  │   │   ├── content-type4.php
  │   │   ├── content-type5.php
  │   │   ├── content-type6.php
  │   │   ├── type1.php
  │   │   ├── type2.php
  │   │   ├── type3.php
  │   │   ├── type4.php
  │   │   ├── type5.php
  │   │   ├── type6.php
  │   │   └── type7.php
  │   ├── carousel.php
  │   ├── content-blog.php
  │   ├── content-none.php
  │   ├── gallery-carousel.php
  │   ├── posts-navi.php
  │   ├── related-posts.php
  │   └── single-author-bio.php
  ├── 404.php
  ├── archive.php
  ├── author.php
  ├── class-tgm-plugin-activation.php
  ├── comments.php
  ├── footer.php
  ├── functions.php
  ├── header.php
  ├── index.php
  ├── page-default-sl.php
  ├── page-default-sr.php
  ├── page-notitle-sl.php
  ├── page-notitle-sr.php
  ├── page-notitle.php
  ├── page.php
  ├── screenshot.png
  ├── search.php
  ├── sidebar.php
  ├── single-classic-boxed-ns.php
  ├── single-classic-boxed-sl.php
  ├── single-classic-boxed.php
  ├── single-classic-fullwidth-ns.php
  ├── single-classic-fullwidth-sl.php
  ├── single-classic-fullwidth.php
  ├── single-classic-ns.php
  ├── single-classic-sl.php
  ├── single-classic.php
  ├── single-default-boxed-ns.php
  ├── single-default-boxed-sl.php
  ├── single-default-boxed.php
  ├── single-default-ns.php
  ├── single-default-sl.php
  ├── single.php
  ├── style.css
  ├── woocommerce.php
  └── style.css

Basics

Getting started

When you looked over the demo, you probably noticed that the theme can group content in multiple layout styles. They are called “Slices”, and there are 7 of them. You can view all of them here.

The number of Slices you can insert in your homepage is basically unlimited, you can group them in what order you want. Each one of them is able carry an array of posts from a specified category and they can be easily accessed though shortcodes.

First of all, we have to create our homepage.

To do that, navigate to Dashboard > Pages > Add New.

Write a title for your homepage, and then, you can start adding some shortcodes.

Let’s say you want a Slice of Type 1. In this case, we will write [slice_type1] shortcode in the editor, just like that:

On the right menu, find the section called Page Attributes and select Page No Title Template.

At the end, dont't forget to click Publish.

The page is now published, but we still have some steps to do. Now, head over Dashboard > Settings > Reading, and on reading settings check for Your homepage displays a static page. Then, from the first dropdown, select the home page that you've just created earlier.

Hit Save and let's proceed to the next step.

Now, we have to tell what posts we want to display in that Slice we have inserted. To do that, head over Customizer > Slice Type 1. There, fill in the blanks with the category from which you want to display posts, and the number of them. Also, if you want to display the latest posts, and not from a category, you can leave the category slug area blank.

Hit Publish in the customizer and you're done.

That's it. The procedure is the same for all other Slice types, and you can insert them in what order you want, in unlimited number.

Slices and Shortcodes List

As mentioned above, there are a bunch of shortcodes you can use in order to display the Slices. They are as follows:

• Carousel

Accesible through [carousel] shortcode. Posts can be added by placing them (also) in the Featured category.

• Slice Type 1

Accesible through [slice_type1] shortcode. Can be customized by accessing Customizer > Slice Type 1.

• Slice Type 2

Accesible through [slice_type2] shortcode. Can be customized by accessing Customizer > Slice Type 2.

• Slice Type 3

Accesible through [slice_type3] shortcode. Can be customized by accessing Customizer > Slice Type 3.

• Slice Type 4

Accesible through [slice_type4] shortcode. Can be customized by accessing Customizer > Slice Type 4.

• Slice Type 5

Accesible through [slice_type5] shortcode. Can be customized by accessing Customizer > Slice Type 5.

• Slice Type 6

Accesible through [slice_type6] shortcode. Can be customized by accessing Customizer > Slice Type 6.

• Slice Type 7

Accesible through [slice_type7] shortcode. Can be customized by accessing Customizer > Slice Type 7.

Abbreviations Used

If you dig enough into this theme, you will see that there are some abreviations used in naming the files, and in the post and page templates.

In order to familiarize you with them, here is a list with their meaning, in case you will stumble upon them:

  • SL stands for "Sidebar Left"
  • SR stands for "Sidebar Right"
  • NS stands for "No Sidebar"

Importing Demo Content

If you want to import the exact content like in the demo, just look in the downloaded archive for an .xml file in the Demo content folder.

Log in into your WordPress Dashboard, and navigate to Tools > Import. Under the name "WordPress" click on Install Now.

After the WordPress Importer is installed, you will have the option to run the importer.

Click on Run Importer.

After that, a dialog will show up, indicating you to upload the .xml file. Press Choose file, select the .xml file from your local machine, and then press Upload file and import.

That's it. All the posts from the demo content are now imported to your site.

Posts

Creating a Post

Creating a post in WordPress is very simple. In dashboard, just navigate to Posts > Add New. There you will find the editor which helps you create all your posts.

The Post Formats

As you may have noticed, in the post editor on the top, there are various options for your post format. This theme supports the Standard, Video and Gallery post formats.

In order for Post Formats to work, you will need to install Vafpress Post Formats UI plugin. The detailed installation guide is present in the Required Plugins section of this documentation.

The diffrence between the Standard and the Video, Gallery post formats, is that these post formats allow you to insert some highlighted content at the top of the post (e.g. a video, an image gallery).

An overall look of the Video post format:

An overall look of the Gallery post format:

The Post Templates

Apart from the three Post Formats mentioned above, the theme also features 15 Post Templates. These can be mixed toghether with the Post Formats, giving thus 45 possible ways to display a post.

In contrast to the Post Formats, the Post Templates are focused on the layout of the post. Each post can be individually customized and can be assigned a diffrent Post Template.

In order to change a Post Template, head over the post editor and choose from the dropdown called Post Atrributes your desired template. If you are not familiar with the abbreviations used there, please read this section of the documentation before.

Adding the Social Share Buttons

In order to add the pre-styled social share buttons at the beginning and at the end of the post, you need to install Neori Social Share plugin. If you have not done this yet, please reffer to this section.

After the plugin has been installed and activated, in the WordPress Dashboard, navigate to Appearance > Neori Social Share Buttons.

On this new page, check whatever icons do you want to show up, and hit Save Changes.

That's it, the social share buttons will automatically.

Pages

Creating a Page

Creating a page in WordPress is very simple. In dashboard, just navigate to Pages > Add New. There you will find the editor which helps you create all your pages.

The Page Templates

The theme also features 6 Page Templates.

The Page Templates are focused on the layout of the page. Each page can be individually customized and can be assigned a diffrent Template.

In order to change a Page Template, head over the post editor and choose from the dropdown called Template your desired template. If you are not familiar with the abbreviations used there, please read this section of the documentation before.

Creating the Contact page

In order to create a Contact Page you need to download the Contact Form 7 plugin. The detailed installation guide is present in the Installing the Required Plugins section of this documentation.

After the plugin has been activated, there are few more steps to go. You will see that in the left menu in the WordPress Dashboard, a new section will appear, named Contact. Click on it, click on Contact form 1 and copy the the given shortcode.

The next step is to create a new page called Contact, where you will paste the code you've just copied. So head to Pages > Add new, and create the new page as follows:

Remember to include your new page in the menu, so it can be visible in the navigation bar.

After you are done, the contact form will look like this:

This theme comes with the contact forms already styled for you. Also, if you want to add further modifications to the form you can also do that from the plugin's settings under Contact section in the dashboard menu.

Creating the Blog Page

In order to create the Blog page, navigate to Dashboard > Pages > Add New.

Write "Blog" in the title area, and hit Publish.

Then, navigate to Dashboard > Settings > Reading, and from Posts page dropdown, select the page you've just created and then hit Save Changes

After that, don't forget to include the page you've just created in your Menu. Details about how to include an item in a menu can be found here.

Customizing

How to customize everything

Every single element in this theme can be easily customized with the help of Yellow Pencil Plugin, so please be sure you have all required plugins installed.

In order to use it, simple click on Edit with Yellow Pencil and then Global Customize from the Admin Bar.

After that you will be taken to the Yellow Pencil's Front End Editor, where editing things is very simple and intuitive.

Hiding things

If you want to hide certain elements within the theme, this can be easily accomplished with the Yellow Pencil plugin.

While in the Yellow Pencil Editor, click on the element you want to hide, and then, in the right Menu navigate to Extra section.

There, look for Display and select none.

Click Save and you're done, the element is now hidden.

FAQ

I am trying to install the theme but it gives me this error "The package could not be installed. The theme is missing the style.css stylesheet."

This error triggers because you were trying to upload the wrong archive. Read more about this here.

How do I setup the theme for the first time?

Information about how to setup the theme for the first time can be found in the Basics section of this documentation.

How do I change the small logo?

Information about how to change the small logo can be found in the Changing the small logo section of this documentation.

How do I make the sidebar sticky?

Information about how to make the sidebar sticky can be found in the Making the Sidebar Sticky section of this documentation.

How do I customize the theme?

Information about how to customize the theme can be found in the Customizing section of this documentation.

How do I hide an element?

Information about how to hide an element within the theme can be found in the Hiding Things section of this documentation.