Savory - Retail WordPress Theme

Created: June 4th, 2013 / Author: Adrian Diaconescu

Thank you for purchasing my theme! If you have any questions that are beyond the scope of this help file or even suggestions on how to improve the theme, the best way to get in touch is via my ThemeForest profile page contact form (right sidebar, at the bottom).

I take feedback very seriously and I always do my best to help out everyone, so you can be sure you'll hear from me sooner or later, depending on my availability and the nature of your issue.

Note: I'm subscribed to the comments section via RSS, so you can leave a message there as well, but please don't ask for support via Twitter or directly on my website, as I try to keep support requests centralized. Thank you!


Table of Contents


1. Introduction


2. Plugin Setup

Before installing the plugin and setting up the content, please make sure you have the latest version of WordPress installed. The plugin should work with previous versions (although WordPress 3 is required), but my advice is to update as soon as possible.

Once you're ready, login into the WordPress admin and follow the steps below:

2.1. Installation

In the ZIP file you downloaded from ThemeForest there should be a folder called retail-menu-cards and a file called retail-menu-cards.zip. There are two ways to install the plugin:

  1. WordPress Upload - Go to Plugins > Add New, then click the Upload link. Choose the ZIP file from your hard drive and click Install Now. Wait for a few seconds for the file to upload, then click Activate.
  2. FTP Upload - If you're familiar with using an FTP client, all you have to do is upload the retail-menu-cards folder into /wp-content/plugins/, then go to Plugins > Installed Plugins and click Activate for Retail Menu Cards.

Note: Do not use the main ZIP file you downloaded (use the plugin ZIP only), otherwise the whole process will fail.

Note: As soon as the plugin is installed, go to Settings > Retail Menu Cards and click Save Changes to set the default plugin settings. You can of course make changes first (and I cover them below), but clicking this button once the plugin is activated is important.

2.2. Plugin Settings

Retail Menu Cards comes with an intuitive, easy to use settings page, that you may use to customize the appearance of the menu cards. You can access it by navigating to Settings > Retail Menu Cards. Here's a description of each setting and how it affect the plugin output:

Display

Currency

Styling

Note: Changes made to the thumbnail width, height or crop only affect future image uploads, not images already uploaded. Scroll below to Recommended Plugins for a tip on how to change thumbnails for older images.

Note: If you don't choose to crop the thumbail to exact dimentions, you can only add either the width or the height and the other one will be dinamically adjusted to keep the thumbnail proportional.

Pro Tip: If you intend to use the a small thumbnail size, first resize your thumbnails to 270x180 and only then add your own size. That way the thumbnail will use your chosen widht and height on large displays, but will not get stretched on mobile displays, where they take 100% of the screen width.


3. Using the Plugin

Once you activate the plugin, you will notice a new section named Menu shows up in the WordPress admin, below the Posts section. This is where you will be able to add, edit and delete menu items, as well as group them by menu cards.

The menu items are custom post types, which basically means they behave exactly like posts, but at the same time allow you to keep your content separated. So you have Items instead of Posts, Cards instead of Categories and Labels instead of Tags. However, the principle behind them is the same:

3.1. Adding Menu Items

Follow the steps below to add your first menu item and set some properties for it:

Note: You have to create at least one Card, that holds all your Items, otherwise the output will be empty.

That's it! You created your first menu item. Repeat the process to add more items and create more cards, or use existing ones. You can also create additional cards beforehand under Menu > Cards. This is also the place where you can edit cards and add a description for them.

3.2. Using the Shortcode

Once you added a couple of meu items and cards, you can use a shortcode to insert one of the menu cards (or all of them) into any page or post. Just add the following to your page / post editor to show all menu items, grouped by menu card:

[rmc-menu]

You can also use the shortcode generator by clicking Insert Menu Shortcode button in the page editor (the one with the open book icon). Here are the shortcode attributes:

Here's an example of using the shortcode with these attributes:

[rmc-menu card="14,17" heading="no" thumblink="image" titlelink="post" look="classic" layout="2col"]

The best way to see how all this works and how it affects the output is to use the syntax mentioned above yourself and experient with these attributes. Just email me if you have questions. ;)

3.3. Using the Widget

Note: Your theme must have at least one widget ready area for you to be able to use this feature.

Retail Menu Cards comes with one custom widget called "RMC Menu Items". It allows you to display a list of menu items, no matter what menu cards they belong to.

Go to Appearance > Widgets and drag the "RMC Menu Items" widget into a widget ready area. You can define the widget title (or leave this empty to not show a widget title), choose one or more menu items to show (use Ctrl + Left Click to select multiple items), as well as choose what the thumb and title link to. You can also select multiple items and just show them as a simple list.


4. Theme Setup

Before installing the theme and setting up the content, please make sure you have the latest version of WordPress installed. The theme should work with previous versions (although WordPress 3.4 is required), but my advice is to update as soon as possible. Ideally you should also start with a clean installation, with no plugins installed (except Retail Menu Cards) and build your website from there.

Once you're ready, login into the WordPress admin and follow the steps below:

4.1. Installation

In the ZIP file you downloaded from ThemeForest there should be a folder called savory and a file called savory.zip. There are two ways to install the theme:

  1. WordPress Upload - Go to Appearance > Themes, click the Install Themes tab, then click Upload. Choose the ZIP file from your hard drive and click Install Now. Wait for a few seconds for the file to upload, then click Activate.
  2. FTP Upload - If you're familiar with using an FTP client, all you have to do is upload the savory folder into /wp-content/themes/, then go to Appearance > Themes and click Activate for Savory.

Note: Do not use the main ZIP file you downloaded (use the theme ZIP only), otherwise the whole process will fail.

4.2. Page Templates

Homepage Template

To build your homepage using the Homepage page template, follow these steps:

  1. Create two new pages: one for the homepage and one to hold your posts, in case you have any. There are no naming restrictions, but "Home" and "Blog" seems like a good way to go.
  2. Go to Settings > Reading and choose A static page for Front page displays, then assign Home for Front page and Blog for Posts page.
  3. Make sure you select the Homepage page template for the page called "Home", in case you haven't on Step 1.

Now you can drag and drop widgets in one of the two widget ready areas, under Appearance > Widgets, and they will show up on the homepage.

Subpages Template

The Subpages page template will generate content for a certain page by using bits of content from its subpages, allowing you to feature those pages using a thumbnail, title and description. You can still add content to the page using the template, that content will show up above the subpage snippets.

Contact Template

Using the Contact page template you can easily set up a page containing a map with a marker indicating the location you enter in the Theme Customizer, under the Address field. You can use the page content to add more details, your contact info or even a contact form.

4.3. Theme Widgets

Besides the Retail Menu Cards widget, the theme comes with three additional custom widgets:

Example:

Mon - Fri|7:00 - 20:00
Saturday|12:00 - 23:00
Sunday|18:00 - 23:00

4.4. Theme Customizer

The theme supports the new Theme Customizer to set up some of the content, as well add some design customization. It's pretty straight forward and here are the options:

Here are some plugins that I highly recommend and why:

This is just a list of plugin I actually used when working on this theme and it's something to get you started. You can find more useful plugins in the Plugin Directory, just don't overdo it. Just because a plugin exists, doesn't mean you have to install it. ;)