First of all, thank you for buying this theme. To make your experience pleasant, we've added as much info as needed in this documentation.

While we have tried to keep an easy-to-use user interface, we understand that you might have some questions about installing and using our theme. Following is a detailed step-by-step guide to help you with most of the questions or issues that you may be experiencing.

How to Use This Document

To help you quickly locate what you are looking for, we have created an extensive menu for this document at your left side. Please use it to navigate to the desired section.

Can't find what you need? Contact us via this form. We will respond in the shortest time possible.

There are two methods to install the theme. If the normal installation method (a) is not supported by your web host, you will have to use the alternate option (b).

a. Normal Installation

1. Log into your WordPress admin panel and go to Appearance → Themes
2. Click the Add New button at the top.
3. Click the Upload Theme button at the top.
4. Click the Choose File button and navigate to the location of the theme zip file appetizing.zip.
5. Click Install Now to begin the installation.
6. Wait for the success message, then click Activate.

b. FTP Installation (alternate method)

1. Unzip the theme zip file appetizing.zip.
2. Using an FTP client to access your host web server. Go to /wp-content/themes/ and place the theme folder inside it.
3. Log in to your WordPress admin panel and go to Appearance → Themes
4. Locate the theme thumbnail and click the Activate link.

ImportantAfter activation, you will be presented with several plugins that you have to activate. Do not forget to activate them all or not all of the theme features will be available.

Appetizing recommends a few plugins to extend it's functionality. These plugins can be installed automatically from the notification in WordPress Administration Panel (Dashboard). Although, Appetizing will work perfectly without any of these plugins, you may want to extend the theme's features with them.

Recommended Plugins

• One-Click Demo Import

  To import content from our demo!

• Instagram Feed

  The plugin allow you to display your instagram feed.

• Mailchimp for WordPress

  Subscribe your WordPress site visitors to your MailChimp lists, with ease.

How to Install the Plugins

1. Log into your Dashboard page.
2. Go to Appearance → Install Plugins.
3. Click install link below the plugin you want to install.

We have included Appetizing with one-click demo importer feature. You can easily to import content from our demo then you can edit it with your content. But first please install all recommended plugins. Please take a look the Installing Recommended Plugins section to read how to install the plugin.

After that please go to Appearance → Import Demo Data, then click the Import Demo Data button. Depending upon the number of content, images and server speed, the process may take long to complete.

ImportantIn some themes you need to install some of the recommended plugins before importing the demo content such as Jetpack, TJ Team Content, Advanced Custom Fields Pro, WooCommerce, etc.

WordPress child theme allows you change the functionality of the theme without having to edit the original/parent theme template files. If you plan to making any customization, we recommend to create a child theme instead of editing the theme template files. Since the child theme is stored separately, you don't need to redo the changes next time you upgrade the theme.

Creating a Child Theme

There's a plugin you can use that will create a child theme from within the WordPress dashboard: http://wordpress.org/plugins/child-theme-configurator/ or you can download Appetizing blank child theme.

Download it here.

More About Child Theme

You can read more about Child theme on WordPress Codex →

If you are migrating from another theme, then upon activating Appetizing you may find previously added images display strangely with weird aspect ratios and sizes. Don't worry. It is normal. The image thumbnails are required to be recreated using Appetizing's presets.

There is a very easy fix to this issue. Just install Force Regenerate Thumbnails plugin.

How To Use It?

1. After you install it, go to Tools → Force Regenerate Thumbnails
2. Click the Regenerate All Thumbnails button
3. Depending upon the number of images and server speed, the process may take long to complete.
4. After it done, you can deactivate and delete the plugin.

The Site Icon is used as a browser and app icon for your site. Icons must be square, and at least 512px wide and tall.

How to Upload your Icon?

• Select Appearance → Customizer
• Choose Site Identity
• You will see the Site Icon uploader.
• Upload your icon at least 512px x 512px

By default, Appetizing styles the site title with pre-defined styles and displays it as Text Logo. If you'd like to upload your custom logo for your site, please follow the steps below:

• Select Appearance → Customizer
• Choose Site Identity
• You will see the Logo uploader.
• Upload your icon at least 250 x 50 pixels

By default, Appetizing uses Montserrat font as default theme font family. But Appetizing provides an option to change it in case you dont like it. It is easy to change it, please follow the steps below.

Access the setting

• Select Appearance → Customizer
• Choose Theme Settings → Fonts
• You will see the settings for each font

How to use it

Each setting have 2 setting Font name/style/sets and Font family , if you want to change the fonts you need to change both.

Please follow the example steps so you will understand how to use it. First please go to https://fonts.google.com/ then choose font you like by clicking the + button.

Then you will see a small popup window at the bottom, click it. You can customize the font style, for example you need a Regular and Bold style. Click the Customize tab then choose the style, please follow the image below.

After that back to the Embed tab. Copy the data, paste it to the Font name/style/sets and Font family setting in the Customizer. If you confuse, please take a look the 2 picture below

Appetizing provides a couple options to choose your prefered colors.

How to use Colors option?

• Select Appearance → Customizer
• Choose Theme Options → Colors
• You will see the option to change the color.

Per Page/Post Basis Layout

You can setup the layout per post or page. This is done when you add or edit the post or page. There are 4 types layout you can choose

How to use it

1. Assuming you're at the new post or page screen (Posts → Add New) or (Pages → Add New)
2. After you create the post or page, scroll down and find Layout meta box.
3. Choose the layout.

Appetizing supports the custom menu function to allow you to setup your menus. You can set it through following steps.

Creating Menu

1. Go to Customizer → Menus.
2. To create a new custom menu, click the create new menu button, give the menu a name, and click Save Menu button.
3. You can add pages, categories or custom link's to the menu using the boxes at the left, add items to the menu and drag/drop to arrange them.
4. And, be sure to select Top Location, Primary Location as the Theme Location before saving your menu.
5. When you are done, click Publish

Appetizing supports a social links menu. You can set it through following steps.

Creating Menu

1. Go to Customizer → Menus.
2. To create a new custom menu, click the create new menu button, give the menu a name, check the Social Links location, then click Next.
3. Click the Add Items
4. Choose Custom Links, then add your social profile links to it.
5. When you are done, click Publish

Custom Widgets

Appetizing comes with 5 custom widgets to give you more flexibility to customize your site.

1. Facebook Like Box: Allow you to display your Facebook Page in a Like Box, hence your reader can 'Like It' directly at your site.
2. Recent Posts Thumbnail: An improvement over the default recent posts widget, including thumbnail.
3. Twitter Timeline: Display an official Twitter Embedded Timeline widget.
4. Social Icons: Display your social media link profile.
5. Address: Display your business address.

Sidebars

Appetizing provides 5 sidebar areas:

1. Primary Sidebar: Main sidebar that appears on the right of your site.
2. Footer Sidebar(1,2,3,4): The sidebar that appears at the bottom of your site.

Custom Sidebars

Appetizing is fully compatible with all of the custom sidebars plugins available for free. Custom sidebars allow you to change the sidebar to display different widgets per post or page.

If you wish to use custom sidebars feature, we recommend the Simple Page Sidebars plugin. It's an extremely powerful and flexible free plugin.

Using the Simple Page Sidebars

1. To use this plugin, first, go to Settings → Reading
2. Under the Default Sidebar select the default sidebar, in this theme you should select Primary Sidebar
3. Go to post or page you wish to change with the new sidebar.
4. Scroll down and find Sidebar meta box(see image below).
5. Click the Enter New link to create new sidebar.
6. Click the Update button.

Then, last step is you only need to go to Appearance → Widgets and choose the widget you wish to use then put it in the new sidebar.

Container layouts is a variation of the theme container. Appetizing provides 3 option to choose:

1. Full Width
2. Boxed
3. Framed

How to Choose it?

• Select Appearance → Customizer
• Choose Theme Options → General
• You will see the option to choose the container layouts.

Featured posts is a list of posts you want to feature. It is based on tag you choose, but If no posts match the tag, sticky posts will be displayed instead.

How to Setting it?

• Select Appearance → Customizer
• Choose Theme Options → Featured Posts
• Set up based on your needs.

We have include a custom shortcode to display a custom Ingredients format. You can see it live here. Or take a look at the image below.

The shortcode is [ingredients]...[/ingredients], this shortcode only allow one argument title. You can use it like this [ingredients title="Ingredients"]...[/ingredients]. To add the ingredients, write it between these shortcode. You MUST add the content in unordered list, here's the example.

[ingredients title="Ingredients"]
<ul>
  <li>1 bunch of wheatgrass</li>
  <li>1/2 lemon</li>
  <li>1 cup sliced pineapple</li>
  <li>2 cups ice cubes</li>
</ul>
[/ingredients]

All of our themes include a language file to make translating to a different language easy. Inside the theme folder /wp-content/themes/themename/languages , you'll find a language file named themename.pot . Or in this theme file named appetizing.pot

Configure WordPress

Before translating the theme, you'll need to make sure WordPress is setup correctly with your locale. Open wp-config.php and modify the line below.

/**
 * WordPress Localized Language, defaults to English.
 *
 * Change this to localize WordPress. A corresponding MO file for the chosen
 * language must be installed to wp-content/languages. For example, install
 * de_DE.mo to wp-content/languages and set WPLANG to "de_DE" to enable German
 * language support.
 */
define( 'WPLANG', '' );

Translating the Theme

1. Download and install Poedit.
2. Open appetizing.pot in Poedit. Translate as needed.
3. Save the file with the locale. For example, if you translate the theme to German language then you would save your files as de_DE.po.
4. Copy both these files(de_DE.po and de_DE.mo) under the languages folder of appetizing.

Resources Used

• HTML5 Shiv - MIT/GPL2
• FitVids - WTFPL
• SlickNav - MIT
• Font Awesome - MIT
• Normalize.css - License
• Owl Carousel - MIT