Mediterraneo - Getting Started

Table of Contents:


To install the theme please follow this  guide. After the activation, you will notice a warning sign, asking you to install the WP Hotelier, Mediterraneo Toolkit and Elementor Page Builder plugins.

  • Mediterraneo Toolkit: The Mediterraneo Toolkit plugin extends the functionality of the Mediterraneo theme by adding three custom widgets. The plugin it’s optional.
  • Elementor Page Builder: A powerful live page builder. That plugin was used in the demo to build some internal pages (“About”, “Cuisine”, etc). It’s entirely optional and you are free to use another page builder (Visual Composer for example). More info about this plugin here.

When you are ready, click on the Begin installing plugins button. Please note: you need to install those plugins before to import the demo data!

Child Theme

This step is not required, but highly recommended. A child theme is the safest and easiest way to modify an existing theme, whether you want to make a few tiny changes or extensive changes. Instead of modifying the theme files directly, you can create a child theme and override within. Because child themes are treated as actual themes themselves, if you begin to set up menus, widgets, customizer settings, etc. in your parent theme, those customizations will be lost when you activate a child theme. for this reason it's recommended to activate a child theme first.

Please note: before to activate your child theme, navigate to Appearance > Mediterraneo License to activate your license (more info here). This section will disappear once you have a child theme installed and activated (to show it again you can switch back to the parent theme).

Why use a child theme?

If you modify an existing theme and it is updated, your changes will be lost. With a child theme,  you can update the parent theme (which might be important for security or functionality) and still keep your changes.

More info about child themes  here.

Import Demo Data

You can import the demo content to quickly set up your website at the same way the demo is set up. Please remember that the original images are not included. As mentioned above, the WP HotelierMediterraneo Toolkit and Elementor Page Builder plugins must be installed and activated before to import the demo data.

You can download the XML file  here (right click and Save as).

To import the XML file:

  1. Go to WP Admin > Tools > Import.
  2. Select and install WordPress importer.
  3. Select the XML file on your computer and upload it (check the Download and import file attachments checkbox). This may take a while, depending on the speed of your internet connection and on the speed of your server: be patient!

Please note: if you have some problems during the import of the XML please read this article.

To finish the demo:

  1. Navigate to Hotelier > Settings and select: the "Available rooms" page in the Listing page option, the "Booking" page in the Booking page option and the "Terms And Conditions" page in the Terms page option.
  2. Go to Settings > Reading and select the "Home" page in the Front page option and the "Blog" page in the Posts page option.
  3. Navigate to Appearance > Customize and setup the homepage, uploading some images to the slideshow and writing a custom title for that page.
  4. Open a room (WP > Rooms) and save it. See the explanation below.

Please note: in WP Hotelier, available rooms are saved in a WP transient. This transient is created when you create/modify/delete a room. In a clean installation, this transient doesn't exist yet (because you need to create a room). And when you import the demo data the transient is not created automatically. If this transient doesn't exist, when you visit the listing page you will receive an error: there are no available rooms. To fix this problem just open a room imported by the demo data and save it. This will generate the transient. 

License Key

To receive automatic update notifications you need to activate your license. Your license key was provided to you in the purchase receipt email. And it is always available on on the  Account page.

Navigate to Appearance > Mediterraneo License. There you will find the form to enter your license key and activate it. 


Mediterraneo uses the native Wordpress Customizer to include the customization options. You can access it by navigating to Appearance > Customize.

Site Identity

There you can upload your site logo and change your site title.

Header Settings

There you can show/hide the book button or show/hide the language switcher navigation (you need to  install WPML to see the menu).

Footer Settings

There you can select the footer layout and write the copyright text.

Sidebar Settings

There you can set the layout of the site's pages.

Room Archive Settings

There you can set the layout of the room archive page.

Blog Settings

This section allows you to show/hide some post's elements (author, date, categories, etc) on the blog page.

Homepage Settings

The theme contains a custom page template for the homepage. To enable it, first create a new page (or use an existing one) and select " Homepage" on the Template dropdown (Page Attributes section). Then you can use the customizer to upload some images to the homepage slideshow, type a custom title and subtitle and set your social links. 


There you can create your preferred color scheme.


The theme uses two font families for the site's typography. In this section you can select a Google font for each of those families or write the name of a custom font (for example "Helvetica"). To use a custom font from a third-party service (like Typekit for example), write the font name in the custom font option and load the embed code somewhere on your website.


Your Mailchimp goes there. It used by the Mediterraneo - Newsletter widget.