Ambrosia's Document

Ambrosia Drupal theme document

In this user guide, you will find all required information to get your site up and running: starting from theme installation and setup, to usage of different post types, page templates and shortcodes. If all else fails or you have any questions about our theme that isn't covered in this documentation, please do not hesitate to submit a support request via our support forum.

We hope you will enjoy working with our themes.

Yours sincerely,

Megadrupal Themes.

Before Getting started

Please note that this theme is not harder to use than any other premium theme with advanced functions. Moreover, we believe that it’s even much easier! And there’s a good reason for that: amount of time that we invested in designing its interfaces, page templates and theme options is simply immense…

Nevertheless, please note that this User Guide does NOT cover basic Drupal usage. Therefore if you are not a confident Drupal user, please get accustomed with it BEFORE proceeding to this manual and theme!

First of all please google “Drupal basics” – plethora of articles and educational videos are available!

Here are some links that will help you to become more confident with Drupal:

Getting started

You can insert your development link (start with http://) below to make some link in this document clickable and go straight to your site

  1. Requirement
  2. Download package contents
  3. Install using demo profile
  4. Manual install
  5. Theme installation errors
  6. Theme update


Let's go over the minimum requirements that you will need in order to have a fully functioning site running our theme.

  • Drupal 7
  • The theme files that you downloaded from
  • Web server: Apache, Nginx, or Microsoft IIS
  • PHP 5.2.5 or higher (5.3 recommended)
  • MySQL 5.0.15 or higher with PDO, PostgreSQL 8.3 or higher with PDO, SQLite 3.3.7 or higher

If you already have a working install of Drupal feel free to skip ahead to theme installation.

Download package contents

Once you have downloaded and unzipped the Ambrosia package you will be faced with a list of files and folders. An explanation of these is as follows. Any item not mentioned here should be ignored for the moment. This is a zip archive of the install profile. This is used for auto install using profile This zip archive includes assets used for manual install. This contains file Libraries,, features modules and

Install using demo profile

Once you have downloaded the Ambrosia package from, there are 2 ways of installing this theme. First way is easy way: using demo install profile. This way is like install standard Drupal. This video below show you how to do this.

You've done, now go to theme settings to custom your website and enjoy it.

Manual install

For manual install, you need install theme & require modules.

Install theme

You can install by using Drupal theme uploader or using FTP

  • Drupal theme uploader

    1. Log into your website
    2. From admin toolbar, click Appearance
    3. Click Install new theme
    4. Browse to the theme's zip file (it is located in the folder you've downloaded from ThemeForest) and choose that file.
    5. Click Install and wait while theme is uploaded to your server
    6. After successfully message, you can click Enable and set default MD Ambrosia
    7. After that, you need to click Theme settings and Save configuration for define some basic settings.
  • FTP

    1. Browse to the theme's zip file (it is located in the folder you've downloaded from ThemeForest) and extract that file, you will get folder named "md_ambrosia"
    2. Open your FTP program and FTP into your site and navigate to the sites/all/themes/ directory
    3. Upload md_ambrosia to this directory
    4. Back to your drupal admin toolbar, click Appearance
    5. Find MD Ambrosia and click Enable and set default
    6. After that, you need to click Theme settings and Save configuration for define some basic settings.

Install modules

After installing MD Ambrosia theme, you can extract (find in zip package) to sites/all/modules/ directory. Then go to Modules to install ambrosia features module.

List modules used in Ambrosia:

Insert content

After install and configure, nothing show in front page (and other pages). Please add some content and see your site working.

Theme installation errors

Do not upload the Themeforest download package directly to your Drupal site, because this will lead to errors. Make sure to Unzip this package and inside you will find the theme zip archive: This is what you will need to upload to your Drupal site

Theme update

When theme has a bug fixes or enhancements, you will be notified to upgrade..

Installing updates is just involves replacing the old theme files with the new ones. It's always a good idea to backup everything before you upgrade, especially if you have made any changes to MD ambrosia's files, as the upgrade will overwrite all files. All custom in theme settings will all remain intact.

Backing Up

  1. It is always a good idea to back up your theme before making any changes
  2. Open your FTP program and FTP into your site and navigate to the sites/all/themes/ directory.
  3. Download the md_ambrosia folder and save it as a backup


  1. Download the new version of the theme from ThemeForest
  2. Browse to the theme's zip file (it is located in the folder you've downloaded from ThemeForest) and extract that file, you will get folder named "md_ambrosia"
  3. Put your site to Maintenance mode (Go to Configuration then Maintenance mode. Make sure the "Put site into maintenance mode" box is checked and click "Save configuration")
  4. Switch to your FTP program, FTP into your site and navigate to the sites/all/theme/ directory.
  5. Transfer the new md_ambrosia folder into the sites/all/theme/ directory on your server, overwrite the existing one.
  6. Clear site cache (Go to Configuration then Performance and click "Clear all caches" button)

Note: If you are running a local server, just copy and override the files.

Adding Content

The Ambrosia theme contains 11 different content types:

About Introduce yourself, your team in general
Blog Create new blogs which are displayed in reverse chronological order
Delivery Food A Delivery Food is a content type which contain product variations
Event Create your events, special occasions here
Gallery Show your product gallery here or whatever
Menu Show amazing a menu with a title, types and images.
Milestone Show special timeline with outstanding milestones
Simplenews newsletter A newsletter issue to be sent to subscribed email addresses
Staff Show your team member's information
Testimonials Show your client's feedback or compliment
Webform Create a new form or questionnaire accessible to users. Submission results and statistics are recorded and accessible to privileged users

To add content, just click Content from admin toolbar and Click Add Content or you can click Add Content from shortcut toolbar.

Adding About

Adding Blog

Blog is not different with other blog type, just click Add content > Blog and add your article.

Adding Delivery Food

Adding Event

Adding Menu

Adding Milestones

View in onepage:

View in multi site:

Adding Simplenews newsletter

Simplenews publishes and sends newsletters to lists of subscribers. Both anonymous and authenticated users can opt-in to different mailing lists.

Adding Staff

Adding Testimonials

Adding Webform

Go to Add Content > Webform to add a new webform

After click Save, you can add elements for your webform

And here is the final view of webform

Customise Pages


In Multipages version of Ambrosia, the theme's pages are built by views. In this section, we will point out how to change those blocks' title/subtitle.

Change block order

To change the block order at homepage, you go to Structure/Pages/Home - Edit, choose Content tab on the left. Here you can drag and drop to change the order of blocks:

Change block title/subtitle

  1. MD Ambrosia Introduction Good Food: Go to Structure/Blocks/MD Ambrosia Introduction Good Food - Configure and change the text.
  2. MD Testimonial: Block: Style 1: Go to Structure/Blocks/>MD Testimonial: Block: Style 1 - Configure and change the text.
  3. MD About: Front: Go toStructure/Blocks/MD About: Front - Configure and change the text.
  4. Custom Highlight: Go toStructure/Pages/Home - Edit, choose Content tab on the left, click on the cogwheel icon of Custom Highlight block and choose Edit and change the text.
  5. MD Blog: Block to front: Go toStructure/Blocks/Footer Contact Information - Configure and change the text.
  6. MD Blog: Contact: Go toStructure/Blocks/MD Block : Contact - Configure and change the text.
  7. Newsletter: MD Ambrosia newsletter: Go toStructure/Blocks/Newsletter: MD Ambrosia newsletter - Configure and change the text.

Change Block Background and Style

Click on Settings (in Style) to change block background and choose Style:

The pop-up opens:

The style here is the serrated lines which separate a block from other ones. (only apply for color background, not image background)

Like this


To customise other blocks in other pages, you take similar steps as customising Homepage

Creating Region

If you used demo install profile, then this setup will be already done. In which case you may only need to modify things. However we still recommend that you read this section carefully because it contains important information which will be useful during modification of the block configuration.

Creating new region

You can follow this article to create new region. This is short introduction:

  1. Open md_ambrosia/ file (with a text editor)
  2. Find regions[footer] = Footer
  3. Insert code after: regions[region_name] = Region human readable name
  4. Save file and go to Configuration > Performance to clear site cache

Locating your region into the theme

  1. Open md_ambrosia/template/page.tpl.php file (with a text editor)
  2. Paste this code to wherever you want to display block region:
    					<?php if ($page['region_name']): ?>
    					  <div class="region-class">
    					    <?php print render($page['region_name']); ?>
    					<?php endif; ?>

Custom Block - MD Block

You go to Structure/Blocks and click on Add MD Block. Then click on the respective MD Block that you want to add and ending up by hit Save block button

We provide the default way of assigning blocks to regions. To do this you go to Structure – Blocks administration menu where you can also specify what roles can see the block, what content type they should appear [or not] in, or even on what paths.

MD Ambrosia Introduction Block

Here you can set your Introduction Block as you want: displayed content, button, background, effect, etc:

MD Ambrosia Instagram

Similar to Ambrosia Introduction Block, in Instagram Block you can set title, background, number of display image,etc

MD Ambrosia Contact Block

Customise Map

To get the Longtitude and Latitude, please visit Google Map. Right click to your location you want to display,choose "What's here?" and Longtitude and Latitude will display in Search Box. You can change 4 type of display Map: ROADMAP, Sate lite, Hybrid, Terrain

MD Ambrosia Hiring Box Block (Onepage version)

MD Ambrosia Header

In Multi Version, Ambrosia Header Block is used in Header region instead of MD Fullscreen Slider in Onepage version

MD Ambrosia About Block

MD Ambrosia About Block display in Onepage Version


This section will guide you how to create pages using panels because some of Ambrosia pages are built by panels module

First, you go to Structure/Pages - Add custom page to give it name and path. Then click Continue button.

Choose the layout that fits your need

Click on the cogwheel icon and Add Content to insert content

You also can customise each block by clicking on cogwheel icon of each block

Note: If you want each block's contextual link to be displayed, you click on Change(below Style) and choose MD Panel Block style or MD Panel Default style in the pop-up, click Next and set the properties

Thus, to customise some available panel pages in MD Ambrosia, going to Structure/Pages and clicking on Edit link of each page will lead you to the customising page, where you can make every change in your page

Theme Settings

In this section we will explain the custom settings that come with the ambrosia theme, where to find them and what you would use them for.

ambrosia's custom theme settings can be found at Appearance > Settings (near MD ambrosia theme).

  1. General settings
  2. Design
  3. Display
  4. Text/Typography
  5. Custom code
  6. Backup & restore

General settings

General settings usually with a global or site wide effect. This tab is open by default when this page is loaded.

Site Settings

Enable or disable some elements like logo, slogan, menu ...

Logo, Favicon & Webclip

Customise or change webclip, logo and favicon icons (A webclip is the icon that appears on a user's iPhone, iPad or Android device if they save your website to their home screen.)

Custom Font

Add your favourite Google text font to the font library here



Enable your preloader, which will display before your site is loaded, here


Configure your site's menu here:

Dark version

Light version

Menu with commerce cart and social icons:

Sub Banner/Pages Title

There are 3 main settings in Sub Banner/Pages Tittle:

1. Page Title Style:

You can make settings for your page title here:

And also Ribbon settings:

2. Sub-banner Background

You can upload background here and set overlay, parallax effect also:

3. Sub-banner for specific pages:

Apply Sub-banner options on specific pages:

Note:The page is divided into 3 main content regions: top, main and bottom.

Content Top

You can enable divider, set background and apply for specific pages

Content Main

Here you can enable divider

Content Bottom

Similar to Content Top:


Here you can set footer background, change the text display and apply settings for specific pages


Social Display

Adding social accounts which appear in Header region


Custom text and typography in all pages.

Custom code

Add custom CSS/JS code into your website

Insert custom code to Header, Footer region or Custom CSS Code here if you want to add additional and customize your site.

Backup & restore

Make and upload theme's backup file

We support you to backup all your file by clicking Backup All Settings and also restore it when you need

Have More Idea?

We are here to build your website!

No Universal solution fits all special business requirements. Our experienced team is ready with ideas and state-of-the-art technical solutions to consult the best solution within your budget.