Installing, Securing WordPress and First Steps

Installing WordPress

If you need help installing WordPress, follow the instructions in WordPress Codex.

Securing WordPress

You can improve your WordPress installation security taking these steps:

  • Set the Authentication Unique Keys and Salts in wp-config.php file.
  • Set the $table_prefix variable in wp-config.php file (do not use the default value of "wp_").
  • Do not use admin as user name and set strong passwords.
  • After installation is done, remove wp-admin/install.php file.
  • Keep backups of the database and WordPress files.
  • Keep your WordPress installation, plugins and themes up to date.
  • You can further strengthen the security of your site by using a specialized plugins and services.

Theme Installation

How to Install the Theme?

Theme purchased on a marketplace

  1. (Re)download the theme package ZIP folder from the marketplace where you've purchased the theme from.
  2. Log into your WordPress admin.
  3. In WordPress admin navigate to Appearance » Themes and click the [Add New] button next to "Themes" page title.
  4. On "Add Themes" screen click the [Upload Theme] button next to page title.
  5. On the next screen choose the theme ZIP package file you've downloaded in step 1 above and click the [Install Now] button.
  6. After the theme is installed, activate it by clicking the "Activate" link.

Free theme available via WordPress.org repository

  1. Log into your WordPress admin.
  2. In WordPress admin navigate to Appearance » Themes and click the [Add New] button next to "Themes" page title.
  3. On "Add Themes" screen use a search field to search for "Auberge".
  4. Once you've found the theme in the search results list, click the [Install] button when hovering over the theme.
  5. After the theme is installed, activate it by clicking the "Activate" link.

Tip: Welcome page

After activating the theme, you can read the theme's welcome page navigating to Appearance » Welcome (you can disable this page in Appearance » Customize » Theme Options » Others).

Important: Subscribe for updates

It is strongly recommended to follow or subscribe to WebMan on Facebook or Twitter to get the most recent theme update notices as fast as possible.

You should always keep your WordPress, themes and plugins up to date!

Theme Update

How to Update the Theme?

You will be notified in the WordPress admin bar each time a new updated theme version is released. To install this updated theme version please follow the steps below.

IMPORTANT:

If there is a specific procedure required for the theme update, this will be clearly stated on the WebMan's Facebook and Twitter pages.

Updating main stylesheet

After each theme update the main CSS stylesheet file gets regenerated to incorporate all the new style changes introduced in the updated theme version. You will get notified about this in the WordPress admin area.

Back Up!

It is strongly recommended to back up your theme settings before you update the theme. This is only a precaution procedure and a good practice.

For backing up the theme (customizer) settings, please use the Customizer Export/Import plugin.

Automatic Theme Update

If none of these apply to you, you need to update the theme manually (see below).

Manual Theme Update

First you need to download the theme ZIP package from your marketplace.
  • Updating via WordPress dashboard

    A simple way of doing a manual theme update would be deleting and reinstalling the theme directly via WordPress dashboard. You can read an article or watch a video on how to do this.

  • Updating via FTP

    This is a more advanced manual theme update procedure and you will need an FTP client (such as FileZilla) to connect to your server:

    1. (Re)download the theme package ZIP folder from the marketplace where you've purchased the theme from and unpack the theme installation ZIP file on your computer.
    2. Now you will need an FTP client to connect to your server.
    3. On your server navigate to YOUR_WORDPRESS_INSTALLATION_FOLDER/wp-content/themes/ folder.
    4. Delete the existing auberge folder (or create a backup just in case).
    5. Copy the unpacked theme auberge folder from your computer (from step 1. above) to the YOUR_WORDPRESS_INSTALLATION_FOLDER/wp-content/themes/ on your server.
    6. Log into your WordPress admin area and check the version of the theme in Appearance » Themes. Your theme should be updated now.

Installing Plugins
Main recommended plugins | Other useful plugins

Why Do I Need Plugins?

Do you ask why do you need to use plugins when you expected the theme to have all the functionality in it?

According to WordPress guidelines, the themes are meant for presentational purposes only, while plugins provide website functionality.

The reason is simple. When you decide to update your website look in the future, you simply change the theme without loosing your website content and additional functionality such as shortcodes, e-shop or forum functionality among others.

This theme follows this basic WordPress philosophy and you can sleep assured your website is as future-proof as possible!

While you get beautiful look for your website with this theme, it also supports and integrates seamlessly with various plugins. For more info please read on.

Installing Recommended Plugins

The theme uses the TGM Plugin Activation script that prompts you to install recommended plugins after you activate the theme.

The suggested recommended plugins are essential to provide the core functionality the theme relies on and/or to ease out the process of editing your website pages. You can still use the theme without these plugins, however, its functionality and your user experience would be limited.

Plugin Compatibility

Other plugins than the recommended ones should work with the theme with no issues, though some might require additional tweaks to integrate them 100% with the theme (this is usually the case of more robust plugins such as e-shop or directory plugins).

Please understand that there are thousands of plugins available for WordPress and it is not possible for any theme developer to test the theme with all of them. Auberge was tested with most of the popular plugins. You can install any custom plugin following the WordPress instructions (or following the plugin documentation).

In case of any plugin incompatibility or error, please, contact the plugin support first before contacting WebMan Design Support Center.

Bellow you'll find a list of plugins that were successfully tested with the theme and works with it without any conflicts:

Jetpack
(https://wordpress.org/plugins/jetpack/)

This plugin was built by Automattic (the company behind the WordPress) and contains a lot of very useful tools for your website.

It provides the Food Menu custom post type and functionality for the theme, that modifies and improves this functionality even further. You will be prompted to install the plugin after the theme activation.

To choose among some of the other features included in this plugin: tiled galleries, image lightbox zooming effect, contact form, custom CSS, extra widgets, infinite scroll, better search, social networks sharing buttons, related posts display, CDN, site verification and others.

For more info on the plugin usage and functionality please visit the Jetpack.me website.

This plugin is required for demo content import

Please install this plugin before importing the theme's demo content XML file. Otherwise the content included in theme's demo content XML file might not get imported in whole.

WebMan Amplifier PLUS
(https://wordpress.org/plugins/webman-amplifier/)

This plugin extends the theme's functionality with recipes functionality and adds a custom "Ingredients" taxonomy.

This is essential plugin to provide Recipes functionality for the theme and you will be prompted to install it after the theme activation.

This plugin is required for demo content import

Please install this plugin before importing the theme's demo content XML file. Otherwise the content included in theme's demo content XML file might not get imported in whole.

Beaver Builder
(https://www.wpbeaverbuilder.com Pro, https://wordpress.org/plugins/beaver-builder-lite-version/ Free)

If you need a page builder plugin to create your pages with ease with a front-end drag and drop editor, I highly recommend using the Beaver Builder plugin. The plugin is available both in free Lite version and payed Pro version. The theme is 100% compatible with this plugin.

For more info on the plugin please see Beaver Builder website where you can also find the instructional videos for this page builder plugin.

This plugin is required for demo content import

Please install this plugin before importing the theme's demo content XML file. Otherwise the content included in theme's demo content XML will not be displayed correctly.

The theme demo content was build using free Beaver Builder Lite Version.

Advanced Custom Fields
(https://wordpress.org/plugins/advanced-custom-fields/)

Use this plugin to create advanced page/post options metaboxes.

The theme integrates with this plugin seamlessly and after the plugin activation there will be additional page/post options available to set (actually, providing a better user interface to set custom fields predefined in the theme).

With this plugin you can create a perfect breadcrumbs navigation.

Read the instructions on custom plugin setup below.

Restaurant Reservations
(https://wordpress.org/plugins/restaurant-reservations/)

Accept restaurant reservations and table bookings online. Quickly confirm or reject bookings, send email notifications, set booking times and more.

Marking your posts as featured ones creates a banner slideshow on your front page.

Other Great Plugins Worth Checking Out

You can use any plugin with this theme. Here are some tested, used and recommended plugins by the theme author:

404page
An easy and very flexible solution for custom error 404 page design.
Caldera Forms
A great form builder plugin for WordPress! Highly recommended!
Custom Post Type Editor
Allows you to rename any post type.
Customizer Export/Import
Perfect plugin for backing up your theme's Customizer settings.
Disable Comments
Disables comments site-wide per post type.
Front-end Editor
Edit your posts on the front-end of your site.
Imsanity
Automatically resizes huge image uploads.
Intuitive Custom Post Order
For easy posts ordering.
Maps Builder - Google Maps Plugin
Let's you build a custom Google Maps to be used in your posts and pages.
My Eyes Are Up Here
Helps you control how WordPress generates thumbnails.
Polylang
Making your WordPress website multilingual. A great free alternative to paid WPML plugin.
Rename Taxonomies
Allows you to rename any taxonomy.
Smart Slider 3
Great free advanced, layered slider plugin.
Theme Check
Checks your themes against the latest WordPress theme review standards.
WooSidebars
For creating unlimited widget areas (sidebars) and using them anywhere on the website.
WP Featherlight
The best free image lightbox (zooming) plugin that just works!

Installing Demo Content

Warning

It is recommended to install theme demo content into empty, fresh WordPress installation only. Otherwise it might mess up your existing content!

Demo Images and Other Media Quality

Please understand that demo images, audio and video files are low quality due to copyright protection and you should replace them with your own, properly licensed images.

Demo Content Import Issues

Please note that there might occur some connection issues when downloading demo attachments (media files) from demo content servers during the demo content import process.

These, however, are just demo attachments (images, videos, audio files) and you are perfectly fine (actually, you should) replacing them with your own assets.

Other demo content (posts, pages and custom posts content) will be imported without any issues.

One-click Installation

For more info on automatic one-click demo content installation please read the Appearance » Welcome » "Installing the theme demo content". After installing and activating required One Click Demo Import plugin, head over to Appearance » Import Demo Data and run the import process.

In case you experience an issue during the one-click demo content import, please read the online information article.

Manual Installation

For detailed instructions regarding each demo content file installation and download, please visit the theme demo files repository at Github.

You can use this procedure in case the One-click Installation procedure fails. In that case it is recommended to delete (permanently) the imported media files from your media library and run the database reset with a plugin such as Advanced WordPress Reset.

Please check WordPress codex for information about manual demo XML file import issues.

Pages

Setting Up Front and Blog Page

  1. In WordPress admin navigate to Settings » Reading.
  2. For "Front page displays" option set "A static page (select below)".
  3. Select the front page from dropdown list. This page will become your home page.
    Select the posts page from dropdown list. This page will become your blog page.
TIP: You can also do this in Customizer where you get live preview of your settings.

Front page

If you set up a static front page, a specially styled condensed posts section and a food menu section will be displayed on the page.

You can set a position or disable these sections in "Layout" section of the theme customizer.

Page Builder

The theme is fully compatible with the best front-end page builder plugin for WordPress, the Beaver Builder, which will help you create a complex page layouts with ease!

Page Templates

The theme contains these useful page templates you can use out of the box:

Fullwidth page Demo

By default, all the pages display with a sidebar. However, if you would like to display a page full width, with no sidebar, use this page template. It is useful template for page builder pages.

Important: When page builder is enabled on this page template, no page title is displayed. Please provide the H1 heading in the page builder then.
Food menu Demo

Use this page template to display a whole food menu of your restaurant, or just a specific section (with its subsections). Please note that you need to have Jetpack plugin installed and activated to use Food Menu functionality.

Also, please note that each food menu section title will get linked to the corresponding archive page. You can disable this linking in "Food Menu" section of the theme customizer.

Important: When page builder is enabled on this page template, no page title is displayed. Please provide the H1 heading in the page builder then.

Posts

Post Excerpt

Post excerpt will be displayed in posts list. If no excerpt set, a portion of post content will take its place in posts list (if set, until <!--more--> tag).

Post excerpt will also be displayed at the top of the post content on single post page (unless you disable it in "Others" section of the theme customizer).

Please note that you will probably have to enable post excerpt field in "Screen Options" (in upper right corner of the screen) first as this is disabled in WordPress by default.

If you set the "Read more" tag inside the post content and you also set a post excerpt, first the post excerpt followed with post content (until "Read More" tag) will be displayed in posts list.

Tip: Changing excerpt size

The default automatic excerpt size in the theme is set up to 18 words (unlike 55 words that WordPress uses by default). If you would like to change this, use this code in your child theme's functions.php file:

function child_theme_excerpt_length( $length ) {
  return 18; // Theme default: 18
}
add_filter( 'excerpt_length', 'child_theme_excerpt_length', 20 );

Table of Contents on Parted Post

If you are setting up a multipage post (using a "Page break" button in visual editor, or <!–nextpage–> tag in "Text" tab of visual editor), the automatic table of contents will be generated for the post/page for you.

All you need to do is to set up a post parts titles at the top of each post part (so, immediately after <!–nextpage–> tag) with H2 heading.

Setting Up a Post Format PLUS

On the post edit screen choose one of the predefined post formats in Format metabox on the right. The theme supports these post formats:

Standard post What is it? Demo

This is basic standard blog post layout.

Audio post What is it? Demo

Displays audio player to play your audio files. Could be used for Podcasting.

To set the audio, use an [audio] (or [playlist]) shortcode in the content. The first [audio] ([playlist]) shortcode will be used in post media area in posts list display, including the post featured image.

If no [audio] or [playlist] shortcode used, but oembed media URL found, this media will be displayed instead of the featured image in posts lists display.

Just add a [gallery] shortcode anywhere in the content. The first [gallery] shortcode images (3 of them) are used as a preview in posts list display.

Image post What is it? Demo

On single post page it acts like standard post, in posts list it displays an image followed by "Excerpt" field content or post title if no "Excerpt" field content set.

Enhances any links in the post content. No post title is displayed.

Quote post What is it? Demo

Displays the post content as blockquote (any blockquotes in the content will be removed and replaced with single wrapping blockquote).

Use <cite> to set the quote source, or set the quote_source custom field, or the post title will be used as quote source. No post title and featured image is displayed.

Status post What is it? Demo

A short status update, similar to a Twitter status update. The whole post content is displayed without excerpt and post title. If no featured image set, the post author avatar is used.

Video post What is it? Demo

Displays a video player to play your video files. Could be used for video blogging.

To set a video, use a [video] (or [playlist]) shortcode in the content. The first [video] ([playlist]) shortcode will be used in post media area in posts list display.

If no [video] or [playlist] shortcode used, but oembed media URL found, this media will be displayed instead of the featured image in posts list display.

Supports also [wpvideo] shortcode when using Jetpack plugin.

Food Menus

What Are They and How to Use Them?

This custom post type is provided via Jetpack plugin.
You can disable this theme functionality in Appearance » Customize » Theme Options » Food Menu and use this theme as a business one or blog recipes one.

Food Menus custom posts are used to display food menu of your restaurant website.

If the food menu item contains any content, the link will direct visitors to view the food menu item page. If you don't set the post content for the food menu item, the link will display full size of the food menu item featured image.

Food menu will be displayed without featured images on your website front page and in full, with featured images, on a "Food menu" page template.

You can use nested food menu sections with this theme (such as create a main section of Drinks and then create a child sections of Cocktails, Beverages,...). However, on your website front page, the food menu will be generated from your main food menu sections. If you would like to display each main section with list of subsections, use a "Food menu" page template and specify the food menu section displayed on the page, or link the food menu section archive page(s) in your website navigation.

Recipes PLUS

What Are They and How to Use Them?

This functionality is provided via WebMan Amplifier plugin.

This is not actually a Custom Post Type but rather an extension for the standard posts and the Food Menu posts.

If you want to display a recipe on a post or Food Menu item page, just set the recipe setup boxes on post edit page in WordPress dashboard. The required field to set for the recipe to display is "Instrucions" - if this field is not set up, recipe won't display on the post page.

Each recipe setup field is self explanatory or contains a description to help you understand what it does and how it displays.

Ingredients are being stored as WordPress taxonomy (similar to tags), so, for example, you can even display them in a tag cloud on your website. When you start typing the ingredient name, the stored ingredient names will be suggested to you, otherwise, if the system doesn't recognize the new ingredient name, it will store it for future reference.

What is It and How to Use It?

On front page of your website the theme displays a banner area with an image and text or with a slideshow of images with a title.

Static banner

By default it displays Header Images (Appearance » Header) and your website tagline (Settings » General » "Tagline").

If you set a Static Front Page you can override the site tagline text by setting banner_text custom field for your front page.

Slideshow

You can display a slideshow of the featured posts in banner area. To set up a featured posts you need to activate the NS Featured Posts plugin and mark some of your posts as featured ones. Post featured image will be displayed in the slideshow alongside the post title (or a banner_text custom field that you set for the post).

Custom slider PLUS

Use Custom Banner widgets area to replace the default theme banner with any content you want. You can insert your custom slider shortcode or widget here.

TIP:

If you want to remove the bottom banner gradient use this custom CSS:

/* This will get rid of the gradient on Custom Banner only: */
.custom-banner:before { display: none; }

/* This will get rid of the gradient on default banner only: */
.site-banner-media:before { display: none; }

/* This will get rid of the gradient on all banners: */
.custom-banner:before,
.site-banner-media:before { display: none; }

Using Navigational Menus

Auberge supports WordPress Menus, so you can easily create custom navigational menus directly in Appearance » Menus.

Custom menus may contain links to pages, categories, custom links or other content types (use the [Screen Options] button in upper right corner of the screen to decide which content types to show on the menu edit screen).

You can specify a different navigation label for a menu item as well as other attributes. The theme supports menu item description text (for submenu items only). To display menus on website you need to assign them to a menu locations or use the Custom Menus widget.

The theme allows you to create as many menus as you want. However these menus can be placed into predefined locations only. The theme defines these menu locations:

Primary Menu
The main navigation area in the header of the website, can be nested and hierarchically organized.
Social Links Menu
Please read the "Social Links" user manual section below for more info.

Please follow the instructions in WordPress codex on how to create menus.

Helpful tutorial: WordPress video tutorials.

Adding Social Network Links and Icons

Social icons linked to your social network profiles can be displayed in the header and footer of your website. But beforehand you must create and set up a social links menu:

  1. Go to Appearance » Menus in the WordPress admin.
  2. Click create a new menu link.
  3. Give the menu a name, such as "Social Menu".
  4. Click [Create Menu] button.
  5. Click the Links header on the left side of the page.
  6. Type a link (such as https://www.facebook.com/webmandesigneu) to one of your social profiles in the URL field.
  7. Give the link a title by typing the name of the service into the Link Text field.
  8. Click [Add to Menu].
  9. Repeat the above steps to add additional social profiles.
  10. In the Menu Settings section at the bottom, check the "Social Links Menu" box for Theme locations.
  11. Click [Save Menu] button.

Adding your social links as a custom menu allows you to sort your profiles and add as many as you want.

The theme currently supports icons for following services: website, email, Codepen, Digg, Dribbble, Dropbox, Facebook, Flickr, Foursquare, Github, Google Plus, Instagram, LinkedIn, Pinterest, Pocket, Polldaddy, Reddit, RSS, Skype, Spotify, StumbleUpon, Tumblr, Twitch, Twitter, Vimeo, WordPress, YouTube. If none of these social services is recognized, the fallback icon is displayed.

Widget Areas

Widget Areas Contained in the Theme

The theme predefines these widget areas:

Sidebar
This widget area is displayed on all pages and posts. If you don't want to display a sidebar on a page, please use a "Fullwidth page" page template.
Custom Banner PLUS
Use this widget area to display a custom banner or slider on the front page.
Front Page Widgets
These widgets are displayed below the banner area on front page.
Footer Widgets
Display widgets in footer area of the website. Widgets will be aligned into columns automatically depending on the number of widgets in the widget area. If you set more than 3 widgets in this widget area, they will be spread into 3 columns, and masonry layout will apply.
You can create a custom widget areas (sidebars) and use them anywhere on the website with a help of WooSidebars plugin.

Customizer

What is Customizer and How to Use It

The theme seamlessly integrates its options into the WordPress Customizer.

You can access it navigating to Appearance » Customize. All the changes you set in Customizer will be immediately displayed in the theme preview. However, these changes will not be saved until you press the [Save & Publish] button.

You can set up your site's title, tagline and logo, header images, manage navigational menu locations and widget areas, set up a front and blog page, theme colors, layout, predefined texts and typography.

All the custom theme options can be found under Appearance » Customize » Theme Options section.

PLUS With premium version of the theme you get more options to control the theme's appearance and functionality.

Why are my changes not being applied on the website?

There might be several different causes of such issue:

Search Engine Optimization and Traffic Tracking

Search Engine Optimization

The theme is coded with best SEO practices in mind, meaning it is ready to be displayed on top of search results in search engines such as Google.

It also integrates Schema.org microformats automatically.

Please note though, that this is just basic SEO optimization and you will have to push it further to make the real deal with SEO. For such cases I recommend Yoast SEO plugin.

PLUS The premium version of the theme supports Google Recipe View for the recipes.

Traffic Tracking

I recommend using Google Analytics by MonsterInsights plugin as it offers advanced customization of tracking of you website.

Localization

How to Translate the Theme?

REMINDER: Any translation files placed in the auberge/languages folder will be deleted when you update the theme.

Translating a theme on WordPress.org

If you have obtained the theme from WordPress.org themes repository, please translate the theme by clicking the Translate Auberge link in theme page sidebar.
  1. Make a copy of the original auberge/languages/auberge.pot file.
  2. You need to rename the copied file now. The naming convention is based on the language code (e.g. "en" for English) followed with underscore and the country code (e.g. "GB" for Great Britain). Also, rename the file extension to "po". So, the British English file would be named as en_GB.po.
  3. Use Poedit to translate the file and export (save) translation also in "mo" translation file format.
  4. Upload translated en_GB.mo file into your WordPress language directory, such as /wp-content/languages/themes/auberge/en_GB.mo. Alternatively you can put translations in your child theme: /wp-content/themes/your-child-theme/languages/en_GB.mo.

Contributing your translations back to the theme

If you would like to help out translating the theme, please contribute on WebMan Design Support Forums.

Theme Modifications and Child Themes Download the sample child theme

When and How to Use a Child Theme?

If you need to make any styling or functional changes to the theme, please use the WordPress native child theme functionality. This way you can continue updating the parent (original) Auberge theme without any worry of your changes being overwritten as all your custom styles and functionality are kept in a child theme. You can read more about child themes on WordPress Codex pages.

You can put all your custom CSS styles into YOUR_WORDPRESS_INSTALLATION/wp-content/themes/YOUR_CHILD_THEME/style.css file. (You can alternatively use a plugin, such as Jetpack, to insert a custom CSS.)

If you also want to change the functionality of the original Auberge theme, do so in YOUR_WORDPRESS_INSTALLATION/wp-content/themes/YOUR_CHILD_THEME/functions.php file. You can freely modify any theme's function here as they are all pluggable. Plus, you can use any filter and action hooks available in the theme source code.

Resources:

Please note that we do not provide support for custom theme modifications, though. You are responsible for all the changes you apply to the theme on your website. If you are not comfortable coding, please, consider hiring someone who could help.

FAQ and Tips and Tricks Frequently Asked Questions and Additional tips for the theme

List of Frequently Asked Questions:

  1. How to customize WordPress admin?
  2. How to set up breadcrumbs?
  3. How to create tables easily?
  4. My images are blurry/small/of bad quality, what can I do?
  5. How to use the Formats button in post editor?
  6. What are custom fields and how to use them?
  7. How to edit the CSS or add your own?
  8. How to use action and filter hooks?

How to customize WordPress admin? Back to FAQ list ↑

If you are building a website for a client using WordPress (and Auberge theme), you might want to adapt the WordPress admin area a bit to remove unnecessary things and maybe even rename some post types. In this case we provide some useful resources you would want to check out:

The theme supports Breadcrumb NavXT plugin that allows very flexible set up and display of breadcrumbs navigation on your website. After you install and activate the plugin, the theme displays the breadcrumbs navigation above and below the page content.

If you would like to display the breadcrumbs navigation the same way it is displayed on the theme demo website, please use these settings (feel free to set up all the other breadcrumbs settings to your need):

Settings » Breadcrumb NavXT » General » "Breadcrumbs Separator"
Set to <span class="sep"> / </span>.
Settings » Breadcrumb NavXT » General » "Home Template"
Settings » Breadcrumb NavXT » General » "Home Template (Unlinked)"
Prepend the existing text with <strong class="breadcrumbs-title">You are here: </strong>….

How to create tables easily? Back to FAQ list ↑

There are times you need to display tabular data in your posts and/or pages. This is not an easy task in WordPress if you are not familiar with HTML coding as there is no out-of-the-box tool to create HTML tables in post editor. But, there is an easy fix for the issue: try using a great TablePress plugin.

My images are blurry/small/of bad quality, what can I do? Back to FAQ list ↑

The theme uses 5 different image sizes:

  • Thumbnail 420 × 280 (cropped)
    This image size is used in posts lists.
  • Medium 632 × (variable height) (scaled)
  • Large 1020 × (variable height) (scaled)
    This image size is set to fill the theme's content area.
  • Banner (auberge_banner) 1640 × 686
    This image size is used for images displayed in the banner area.
  • Small Banner (auberge_banner_small) 1020 × 426
    Smaller version of the Banner image size used for food menu featured images, for example.

WordPress will rescale and crop the images to selected formats automatically during the image upload process. If you already have some images on your website, these need to be rescaled when using the theme. Please use a plugin such as Force Regenerate Thumbnails to do the rescaling for you.

Image file size

It is recommended to use the Imsanity plugin to keep the sane size of the uploaded images on your server automatically.

Set the plugin to your (boxed) website container width (you can tweak this in theme customizer) and lower the image quality to value of 70 (or to your preference).

"Lightbox" image zooming

If you would like to use a lightbox effect (image zooming), try using great WP Featherlight plugin.

High DPI (Retina) screen images

To keep your images high DPI (Retina) screen ready, consider using WP Retina 2x plugin.

Speed

To speed up your website loading time consider using a CDN on your images, such as Jetpack's Photon or CloudFlare (or any other CDN).

How to use the Formats button in post editor? Back to FAQ list ↑

The theme adds a new Formats button to the visual editor of WordPress posts/pages. Please use this button to create a special elements, such as pullquotes, cite source, inline code, super/sub-scripts, uppercase text, highlighted (marked) text.

For all the formats please select a text in post/page content first. The format will be applied on this selected text then.

Text styles » Dropcap text

Apply the "Dropcap Text" format on the paragraph of text, not the single character.
Visual editor Format button
Illustration image only

What are custom fields and how to use them? Back to FAQ list ↑

To allow more control over pages and posts appearance, the theme uses some predefined custom fields. Here is the list of the fields explained:

food_menu_section
Set this field on "Food menu" page template only to a value of a food menu section ID. Once set, the specific food menu section is displayed on the page instead of the whole menu.
banner_text
Set this on featured posts or on your front page (if you are using static banner instead of slideshow). This text will override the default text displayed in your website front page banner.
quote_source PLUS
Set this on Quote post formats only to customizer quote source.

TIP:

For easier setup of custom fields please install and activate the Advanced Custom Fields plugin. Once you activate this plugin, the theme will automatically creates a metaboxes for all the custom fields it uses for the specific post types.

Advanced Custom Fields metaboxes on Pages
Illustration image only

How to edit the CSS or add your own? Back to FAQ list ↑

If you need to apply a custom CSS to override theme styles, please use a child theme or custom CSS plugin (such as Jetpack's Custom CSS or Reaktiv CSS Builder or Theme Junkie Custom CSS).

How to use action and filter hooks? Theme development and modifications Back to FAQ list ↑

This topic is dedicated to WordPress developers who would like to modify the theme and alter or expand its functionality.
Please note that we do not provide support for custom theme modifications, though.

The theme is coded according to WordPress coding standards and is full of action and filter hooks. You can easily hook onto these to alter functions outputs or alter parameters and variables, to add your own meta data, theme or design options, layouts and much more!

Please check the theme's source code for which hook to use, or contact WebMan Design Support Forums for more details and tips.

Auberge itself uses the Theme Hook Alliance hooks too. This is useful to entirely rebuild the theme structure or add your own sections anywhere in the theme.

You can also watch an instructional video on how to use WordPress hooks.

Sources and Credits