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. Unlock Adomus menus by validating your Adomus licence
3. Install HBook and HTestimonials plugin which are bundled to Adomus (standalone plugins).
4. Unlock HBook menus by validating your HBook licence
5. Load the demo content if you wish to start editing from there

If you wish to do some customization on Adomus, we recommend to create a child theme so your customization won't be erase when you'll update the theme.

Theme installation

1. When you download Adomus theme, you get a zip file of the theme and it it simply this zip file that you will upload to install the theme.
2. There are 2 ways to install a WordPress theme:
   • using the WordPress installer
   • uploading the theme via FTP

---

Using the WordPress installer

1. Go to Appearance > Themes
2. Click Add new

3. Click Upload theme
4. Click Choose file and select the adomus.zip file
you downloaded
5. Click Install now

6. Once the theme has been installed click Activate Theme

---

Uploading the theme via FTP

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

4. Find the Adomus theme and click Activate

---

Child theme

• Use of child theme

  If you don't plan to make any CSS/HTML/PHP customizations, you don't need to create a child theme.
  If you want to customize Adomus theme, you should create a child theme. So you can modify the child theme without editing the files of the parent theme itself. That way, when the parent theme is updated, your modifications are preserved.
  For this reason, child themes are the recommended way of making modifications to a theme.

  See Wordpress codex for more information regarding child theme.

• Creating a child

  You can download Adomus child theme from our website here. You just have to install the adomus-child.zip file as if it was a theme (use the WordPress auto-installer or a FTP software).

  Now, to customize the theme, just edit the child theme and when you upgrade the theme, just overwrite the parent theme and there's no messy "recreating my customizations" process.

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.

Notifications of an update release

• If you purchased Adomus on our website, you will reveive an email each time an update is available.
• You can also check if there is a new update directly on Adomus changelog page.

Update your theme

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

1. Download the theme again from our downloads page :
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.

Theme licence validation

You received a Purchase code in the purchase confirmation email sent from sales@maestrel.com. If you can't find it, feel free to email us via the contact page here.

In Appearance > Adomus - Licence, you will enter your Purchase code to validate your licence.

When your licence is validated, you will see that all Adomus menus are unlocked:

Bundled plugins installation

Adomus theme comes with two plugins developed by us:

• HTestimonials
• HBook

These bundled plugins are pre-packed with Adomus theme therefore their installation and activation are easy and quick. Follow the steps below:

1. Select Appearance > Install Plugins


2. Select both plugins, select Install in Bulk Actions, and click Apply


3. Wait until the plugin are installed and activated.

HBook licence validation

You will use your Purchase code to unlock as well HBook menus. You can find this purchase code in the purchase confirmation email sent from sales@maestrel.com. If you can't find it, feel free to email us via the contact page here.

In HBook > Licence, you will enter your Purchase code to validate your licence.

When your licence is validated, you will see that all HBook menus are unlocked:

If you have any troubles validating your HBook licence, please refer to this article of our knowledgebase..

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.

In Appearance > Adomus demo install, you will find our demo installer tool.
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.

Booking system

The booking system that is included in Lavilla theme is our own booking system plugin, HBook.

You can find the documentation for HBook plugin here.

Sections and templates

This section of the documentation presents the different page templates and gives details about Adomus sections, which is great tool for you to build a variety of pages with simplicity.

Adomus offers 2 page templates:

• Default template: this is a full width one centered column template. With this template, you can use Adomus sections and you can as well include a booking form within the hero.
• Page with sidebar: this is a page with a sidebar on the right

---

Adomus theme comes with a a choice of sections that will allow you to build your pages easily by choosing and arranging different sections. It is a great tool for you to build a variety of pages with simplicity. Each sections comes with its own settings and they are described below.

If you wish to use Adomus sections in a page, simply set it in Page sections:

1. Set that you wish to use Adomus sections for this page
2. You can select which sections you wish to add
3. Here you can expand or collapse the section settings

1. You can use several times a same section type.
2. You can re-order the sections to your taste by dragging and dropping.

---

The different sections you can pick from are as follow:

• Pages
• Accommodation
• Testimonials
• Posts
• Video
• Slider / text/ Owner image
• Text / Image
• Gallery
• Call to action
• Map / Contact
• Custom content
• Editor content

You can select which sections you wish to display and you can re-order the sections to your taste by dragging and dropping. You can use several times a same section type.

1. Select wich section type you wish to add
2. You can drag and drop the sections to re-organize them
3. Here you can close the section or delete it

---

Pages

This section is a 2 or 3-columns section, which can be used to display different information contained in Pages.

1. Add a tagline for the section
2. Add a title for the section
3. Enter the ids of the pages you wish to display
4. Select if you wish to display the content of the page or the excerpt
5. Select if you wish to link the title to the page
6. Select if you wish to display a button Learn more
7. Choose which type of link you wish for the featured image

---

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

---

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

---

Posts

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

---

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...)

---

Slider / Text / Owner image

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. You can set it so it displays:

• a slider, a text and an image
• a slider and a text
• 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

---

Text / Image

This section is a 2 columns section, which can be used for a present some features or information.

1. Add a tagline for the section
2. Add a title for the section
3. Select the layout
4. Enter your text for the text column
5. Add an image

---

Gallery

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)

---

Call to action

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 / Map

In order to display maps on your website, you need to :

1. get a Google API key. Please refer to this page: Get API Key
2. enter the Google API key in Appearance > Customize > Map. Please check this section of Adomus documentation.

This section is a one or two-columns section that can display a contact form, a map or/and contact information. The layout options are:

• contact form and a map
• contact information and map
• contact information and contact form
• a contact form only
• a full-width map

1. Select the layout
2. Select the positionof an element (Map, Contact) depending on the layout chosen
3. Add a tagline for the contact form or the contact information
4. Add a title for the contact form or the contact information
5. Enter here your contact information (if selected in the layout)
6. Select the type of map to display
7. Add the zoom for the map
8. Enter here the latitude of the first point
9. Enter here the longitude of the first point
10. Add the caption text
11. Click here to add another point and proceed the same way

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

---

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.

• You can choose from the following hero types:
  • an image
  • a slider
  • a video
  • a custom hero


• Post and pages have a section where you can set your hero options.
  1. Select the type of hero: image, video, slider or custom
  2. Choose if you wish to display the hero full screen or not
  3. Choose if you wish to display the title of the post/page
  4. You can add a tagline
  5. You can add an alternative title to be displayed instead of the post/page title
  6. Choose where the title should be: default, inside hero or below hero. The default position is set in the customizer.
  For hero type as image and slider, you will have as well the following options:
  7. Enter a ratio (example: 16/9, 3/2, etc...)
  8. Enter a minimum height for the hero
  9. Enter a maximum height for the hero

---

An image as a hero

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

• If you wish to use the featured image, you do not have to change anything
• If you wish to use another image, click on Add image to open the media library

---

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

• With the advanced layout template you can have a booking form in the hero.
  1. Indicate if you wish to display a booking form
  2. Enter the id of the main booking page

---

Sliders

• You can manage sliders in the menu Sliders:


• The Sliders page is straightforward:
  1. Click Add a Slider to create a new slider
  2. Click Edit Slider to edit a slider
  3. Click Delete Slider to delete a slider
  4. Do not forget to Save all your changes


• Each slider has the following settings:
  1. Enter the name of the slider
  2. Set if you wish the slider to autoplay
  3. Set the duration of the display of each slide (in miliseconds)
  4. Set the duration of the transition between slides (in miliseconds)
  5. Choose the transition style
  6. Click this button to add a slide before the first slide
  7. Add a caption to the slide
  8. Click this button to delete the slide
  9. Click this button to add a slide after the last slide

You can re-order slides by dragging and dropping.

Testimonials

• The Testimonials page is straightforward:


• If you want to add a testimonial, follow the instructions below:
  • Click Add New.
    
    
  • Fill in the new testimonial post:
    
  2. Enter a title for your testimonial
  3. Use the editor to enter the content
  4. Enter the author's name
  5. Enter the author's location
  6. You can add a featured image
  7. Don't forget to Publish!

Contact

Contact details

In the menu Appearance > Adomus Contact details, you will be able to set your contact details information.
In Appearance > Widgets, you can add the widget "Contact Details".

Please refer to Header and Footer section of the documentation.

---

Contact form

In the menu Appearance > Contact Form, you will be able to build your contact form and to define the email settings.
This information will be used:

• when you display a contact form with the section Contact / Map section
• when you use the [hb_contact_form] shortcode which allows you to display a contact form anywhere on your site.

Form builder

• Add any type of field: Text, Email, Number, Text area, Select, Radio Buttons, Check Boxes, Title, Explanation.
• Items can be reordered by dragging and dropping them

Email settings

• For each of the field used to build your contact form, you will find a corresponding variable ( ex: [contact_name] ).

Customizer

You can access to the customizer from the menu Appearance->Customize. The customizer has different sections:

• Site identity, Menus, Widgets, Homepage settings are not specific to Adomus theme
• Hero, Colors, Map, Misc, Footer, Custom CSS are explained below

---

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
7. 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.

To get you Google Map API key, please refer to this page: Get API Key.

---

Misc

This section is only for the padding between images in gallery section.

---

Footer

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.

Header and Footer

In Appearance > Widgets , you will see Adomus sidebar areas as well as Adomus Contact details widget.
This is where you will be able to set the different widgets you wish to use in the top header section as well as in the footer.

Please note that the footer can be either 3 columns or 4 columns.

Strings customization and translations

In the menu Appearance > Adomus theme strings, you will be able to easily customize or translate all strings of Adomus theme.

• If you wish to import or export a file for a specific language, you can do so with the Import/Export tool.
• You will find a list of front-end strings that can be customized or/and translated.

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 HBook 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.

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?

Where is the Post excerpt?

• The excerpt is located below the Post Options.

• If you don't see it you have to make it appear via the Screen Options:
  
  1. Click on Screen Options
  
  2. Tick the Excerpt box