Adomus theme documentation

If you have any questions that are beyond the scope of this documentation, please feel free to email us via the contact page here.

Getting started

Here are the steps you should follow before you begin to edit the content of your site:

  1. Installing the theme
  2. Load the demo content if you wish to start editing from there

Theme installation

There are 2 ways to install a WordPress theme:


Using the WordPress installer

  1. Go to Appearance > Themes
  2. Click Add new
  3. Click Upload
  4. Click Choose file and select the adomus.zip file
  5. Click Install now
  6. Once the theme has been installed click Activate Theme

Uploading the theme via FTP

  1. Unzip the adomus.zip file
  2. Upload the adomus folder into the wp-content/themes/ folder on your server
  3. Once the theme is uploaded log into WordPress and go to Appearance > Themes
  4. Find the Adomus theme and click Activate

Child theme

Theme updates

In order to add new functionalities, to stay up to date with the WordPress software evolution, to correct bugs, Adomus theme is regularly updated.

Updating does not affect the content of your site. Your posts, settings, plugins, themes, or your media files... will stay the same. Don't worry!

Notifications of an update release

Update your theme

If you want to update your theme, follow these instructions:

  1. Download the theme again from your ThemeForest downloads page :
    • Go to the Downloads page
    • If you download "All files and documentation" you'll find the latest version in the theme/ folder of the .zip package
    • If you download "Installable WordPress file only" the .zip file you'll get is the latest available version of the theme and it is the file you need to upload in WordPress
  2. Backup your website!
    This is not compulsory but periodically backing up your entire installation (entire directory structure + database) is a good idea, especially before making any type of update to themes, plugins, core files, etc. Learn more about backups here.
  3. Upload the updated theme
    • Rename the existing adomus/ folder which is in the wp-content/themes/ folder in something like adomus_before_update_to_version_2 (so the previous version is saved in case something goes wrong).
    • Simply follow the standard FTP Installation instructions - upload the new theme to the wp-content/themes/ folder.

Demo Content Installation

You might find it handy to use the Demo site as a starting point to create your site. We have made it easy!

Note that loading the demo content will delete any previous posts or pages with their meta, sidebar settings, menus.

Note that this process might take several minutes. Be patient! When the demo installation is finished, a banner will appear with a message to inform you that the demo content installation is done.

To load the content and options of the Demo, follow the instructions below:

  1. Click on Demo content installation
  2. A pop-up window will open, asking you to confirm. Click OK to confirm.
  3. The installation can take several minutes. When it is done, a message will appear.

HBook - online booking system

You can find the documentation of HBook plugin here.

Page templates

This section of the documentation presents the different page templates and explains more in depth the Advanced layout template which is great tool for you to build a variety of pages with simplicity.

Adomus offers 3 page templates:

Advanced layout template

Adomus theme comes with an advanced layout template that will allow you to build your pages by choosing and arranging different sections.
With the advanced layout template, you will have additional options for the hero and a list of sections to pick from to build your page.


Advanced sections

The different sections you can pick from are as follow:


Text, image and slider

This section is a 2 or 3-columns section, which can be used for a welcome word or any other presentation. Colums are respectively a slider of images, a text and an image.

  1. Add a tagline for the section
  2. Add a title for the section
  3. Enter your text for the text column
  4. Add an image for the image column for medium/large screen
  5. Add an image for the image column for smaller screen
  6. Select the images for the slider
  7. Indicate the autoplay speed


Video section

This section allows you to add a YouTube video:

  1. Add a tagline for the section
  2. Add a title for the section
  3. Enter a video introduction text
  4. Add an image for the background image
  5. Enter the YouTube video id
  6. Enter a ratio for the video (example: 16/9, 3/2, etc...)


Accommodation section

This section allows you to display your accommodation types. The featured image, along with the title and the hero tagline of the Accommodation type post.

  1. Add a tagline for the section
  2. Add a title for the section
  3. Select the accommodation types you wish to feature


This section allows you to display a gallery of images with an introduction text.

  1. Add a tagline for the section
  2. Add a title for the section
  3. Select the layout: if you do not wish to include a text, select "Description center".
  4. Enter a description here
  5. Select the images for the gallery section
  6. Enter the text that will be displayed as a link to your gallery page (optional)
  7. Enter here the id of the gallery page to link to (optional)


Testimonials section

This section is aimed at displaying testimonials. It has different layout and navigation options.

The testimonials are created in Testimonials menu. Check this section of the documentation for detailed information.


  1. Add a tagline for the section
  2. Add a title for the section
  3. Select the layout
  4. Choose how visitors can navigate from one testimonial to the other
  5. Choose which testimonials you wish to feature


News section

This section is a two columns (in wider screen) to dislplay a list of your last posts: one column for the featured image of the post and one column for the excerpt.

  1. Add a tagline for the section
  2. Add a title for the section
  3. Enter the number of posts to be displayed.
  4. Choose a layout for the excerpt/ featured image
  5. Indicate if you wish to display meta information for each posts
  6. Choose which category/categories of posts you wish to be displayed


Call to action section

This section allows you to dislplay a call to action.

  1. Enter the text to be displayed
  2. Enter thetext for the link
  3. Indicate the id of the page to link to.


Contact section

This section is a two-columns (on wider screen) that dislplays a contact form in the left column and contact information in the right column.

  1. Add a title for the section
  2. Add a tagline for the section
  3. Enter here your contact information

The contact form display the fields as set in Contact menu.


Map section

This section allows you to dislplay a map. You can set several pointers in the map.

  1. Select the type of map to display
  2. Add the zoom for the map
  3. Enter here the latitude of the first point
  4. Enter here the longitude of the first point
  5. Add the caption text
  6. Click here to add another point and proceed the same way


Editor content section

If you wish to display the content of the default editor, use this section.


Custom content section

If you wish to display custom content, use the editor of this custom content section.


Hero options

This section of the documentation presents the different options Adomus offers for the hero.
It deals as well with advanced template layout additional hero options.


An image as a hero

If you wish to have an image as hero, you can either use the featured image or another image.


A slider as a hero

If you choose to have a slider as a hero, just select which slider you wish to have.

For more detailed information regarding the Sliders, see here.


A custom hero

You can choose to have a custom slider ; you will enter a shortcode to be executed.


A video as a hero

You can choose to have a You Tube video as hero:

  1. Select Video as Hero type
  2. Enter the video id
  3. Enter a ratio for the video (example: 16/9, 3/2, etc...)
  4. Add the background image to be shown before video is played


Advanced hero options


Sliders

You can re-order slides by dragging and dropping.

Testimonials

Contact Form

In the menu Contact Form, you will be able to build your contact form and to define the email settings.

You can insert this contact form anywhere in your site thanks to [hb_contact_form] shortcode.

Form builder


Email settings

Customizer

You can access to the customizer from the menu Appearance->Customize:


The customizer has different sections:

Top Hero

This will add the contact details at the top of the hero. It is pretty straightforward:

Hero

In this section of the customizer, you can add your logo and set the default settings for the hero:

  1. Select the image for your logo. Leave it empty if you wish to diplay your blog title.
  2. Choose the default hero image
  3. Choose the default title position: inside hero or below hero
  4. Choose the default hero ratio
  5. Choose the default hero minimum height
  6. Choose the default hero maximum height

Note that you can override the default settings for a post or a page. Please refer to Hero options section of the documentation.

Colors

Here you can change the accent color, the color when hovering on links, the header background color and you can as well set the color and opacity of the overlay. It is pretty straightforward:

Map

This section allows you to enter the Google Map API key which is needed for the maps to be displayed.

This section allows you to customize the footer:

  1. Add a copyright text
  2. Insert here your social media links

Custom CSS

You can add custom CSS in this section of the customizer, which means you can check directly the changes.

Multi-language

In order to create a multi-language website you will need to use a multi-language plugin. There are several multi-language plugins available. Adomus theme is compatible with WPML and Polylang.

Translate Accommodation pages with WPML

Once you have activated and configured WPML plugin you need to make the "Accommodation Custom posts" translatable.

  1. Click Translation options
  2. Select Translate
  3. Click Save

You can now translate the Accommodation pages. Note that you don't have to enter the Accommodation settings in the translated page again (except the Description fields).

Translate Accommodation pages with Polylang

Once you have activated Polylang plugin you need to make the "Accommodation" translatable.

  1. Click Languages to access the Polylang setting page
  2. Check the Accommodation box
  3. Click Save Changes

You can now translate the Accommodation pages. Note that you don't have to enter the Accommodation settings in the translated page again (except the Description fields).

For the translation of the text displayed during the booking process, refer to this section of the documentation: Text customization and translation.

Theme translation

Adomus theme follows the standards of WordPress internationalization. Below are instructions on how to translate Adomus theme with Poedit.

Note: these instructions would be the same for any other internationalized theme. You can learn more about translation and WordPress here: http://codex.wordpress.org/Translating_WordPress.

  1. Download and install Poedit
  2. Open the adomus/languages/default.pot file in Poedit
  3. Create your .po and .mo files by going to File -> Save as...: choose the wp-content/themes/adomus/languages/ folder and add the correct locale to name the file name (for example for a French translation: fr_FR.po)
  4. Translate the strings you will use on your website
  5. Save again to update the .po and .mo files

FAQ

Where is the Post excerpt?