MD Caruso's Document

MD Caruso Drupal theme document


Caruso_Minimal Multipurpose Portfolio Drupal Theme

Version 1.0

Thank you very much for purchasing our theme. 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

Requirement

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 themeforest.net
  • 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 Caruso 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.

caruso_install_profile.zip This is a zip archive of the install profile. This is used for auto install using profile
Manual install This folder includes assets used for manual install. This contains file Libraries, md_caruso_7.x-1.0.zip and module.zip
Documentation This is the help documentation. To view simply open index.html found inside this folder

Install using demo profile

Once you have downloaded the caruso package from Themeforest.net, 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 Caruso
    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_caruso"
    2. Open your FTP program and FTP into your site and navigate to the sites/all/themes/ directory
    3. Upload md_caruso to this directory
    4. Back to your drupal admin toolbar, click Appearance
    5. Find MD Caruso 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 Caruso Theme, you can extract modules.zip (find in zip package) to sites/all/modules/ directory. After install module Caruso features, please go to admin/structure/features to install all modules there.

List modules used in Caruso:

Modules

Contrib modules:

Custom modules:

  • MD Awecontent
  • MD Field
  • MD Slider
  • MD theme
  • shortcodes

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: md_caruso-7.x-1.0.zip. 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 Caruso'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_caruso folder and save it as a backup

Upgrading

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

Site Menu

In this section, we will outline the steps involved in creating the menu for this theme.

Creating menu

  1. Go to Structure/Menu in the toolbar and click List link near Main menu.
  2. At first you will probably need to add a menu, click Add link & give it a name, link, where to scroll and save it.
  3. Now you can drag the newly inserted menu item to their correct sequence.
  4. After you have added and edited the menu items click Save Configuration in the bottom of this area.

Adding Content

The Caruso theme contains 9 different content types:

Activity Show off and create your activities here.
Attraction Create posts to show how attracted you are.
Blog Create new blogs which are displayed in reverse chronological order.
Event Create or show off interesting and special events here.
Gallery Show case your amazing pictures or whatever with gallery content.
Guest book Customers' reviews about your hotel and services.
Restaurant Show your wonderful menu and signature here.
Simplenews letter A newsletter issue to be sent to subscribed email addresses.
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 Activity

Go to Add Content > Activity to add new acivity.

Open in detail:

Adding Attraction

Adding Blog

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

Open in detail:

Adding Event

Adding Gallery

Style 1 - Width 1

Style 2 - Width 2

Adding Guest Book

To add customers' reviews, please go to Add Content > Guest Book.

Adding Restaurant

Adding Simplenews

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

Adding Webform

You just go to Add content > Webform. After naming the form, just add form components:

In addition to Webform, you can create other ones like reservation form, check availability form, etc

Adding Room

Creating Room Type

Before adding rooms, you need to create Room Type by going to Rooms > Bookable Units then choose BOOKABLE UNIT TYPES tab and click on Add bookable unit types

Adding Room

To add rooms, you go to Rooms > Bookable Units > Add a bookable unit then choose the Room Type. Then you will be led to the setting page:

Then you go to Add Content > Unit Description

Customize

This section will guide you how to customize your Caruso site

Homepage

Most of pages are built by MD AWEContent module. For example Home page: to customise home page, please click on Edit: (admin mode)

Then Click on Build page with AWEContent

Then you can edit/customize every section content and image. For more detail and instruction, please see AWEContent Documentation which is also packed in the package

However, there still are some static blocks which are built by views. In this section, we will point out how to change those blocks' title/subtitle.

  1. Currency selector: Go to Structure/Blocks/Currency Selector - Configure and change.
  2. Sign up for newsletter: Go to Structure/Blocks/Newsletter: MD Carosu newsletter - Configure and change text.
  3. Connect with us: Go to Structure/Blocks/Caruso Social Footer - Configure to change/ edit.
  4. Contact: Go toStructure/Blocks/Contact Information - Configure and change the text.
  5. Hotel: Go toStructure/Blocks/Hotel - Configure and change the text.
  6. Inquire: Go toStructure/Blocks/Inquire - Configure and change the text.
  7. Latest Tweets: Go to Structure/Blocks/Tweets - Configure then edit/ change.
  8. Payment: Go to Structure/Blocks/Payment - Configure then edit/ change.

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

The Caruso theme come with 5 block regions.

Assigning block

Blocks are placed in regions via the Block Admin page Dashboard > Structure > Blocks. Here you can

  1. Enable, throttle, place, and configure blocks
  2. Add a block

Creating new block region

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

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

Placing your block region into the theme

  1. Open md_caruso/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']); ?>
                </div>>
              <?php endif; ?>
              

Theme Settings

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

Caruso's custom theme settings can be found at Appearance > Settings (near MD Caruso 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

Design

Header

Edit top header information

Sidebar

Choose the sidebar position

Contact Information

Change your contact information here

Final view:

Footer

Distribute blocks in Footer region, customise Copyright, Footer image, Back to the top text

404 Page

You can customise your 404 page here: Content, image

This is how it looks like:

Coming Soon

Customise your under-construction page here

Preloader

upload your preloader image which will display before your site is loaded

Flickr

Adding Flickr account which appears in Blog pages

Text/Typography

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

General information

Need help?

If you need help with setting up the template, please post your question here. There are a few notes:

  • Before you ask a question please make sure to scan the menu and read the specific section of your question.
  • If it's a specific Drupal module question, Google (or any other search engine) is your friend and probably a hundred times faster in replying.
  • If it's possible, please provide a link to your (demo) website so our stuff are able to quickly scan for possible issues.

Report a bug

If you found a bug, please send us an e-mail with a (small) description of the issue. Your help is always apreciated.

© 2014 MegaDrupal. All Rights Reserved.

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.