Please note: This site will be closing down soon!
For now, only use the themelets setup guides here.
All other documentation has moved to getmorph.org.

Mocha Setup Guide

Getting Started

There are 3 different approaches you can use to setup this themelet. We have separated the setup guide based on the starting point for each of these approaches.

The Morph Quick Installer

This is the recommended setup process. Also the easiest and will make your site look identical to the demo. It is the ideal platform to learn a lot about both Joomla and Morph due to the included sample content.

Go to guide

The Joomla Installer

This setup process is similar to using the Quick installer but instead of our sample content, it uses Joomla's sample content. This method requires more steps so we recommend to use the Quick installer instead.

Go to guide

On an existing site

This process is if you have an existing Joomla site with content that you want to install a themelet on. This method is the most complicated and requires many more manual steps to setup your website like the demo.

Go to guide

 

1. Getting setup using the Morph Quick Installer

This guide will take you through the steps on how to setup the Mocha themelet using our quick installer. This is the quickest way to get setup with this themelet so that it looks like the demo. After these steps are complete, you will have your own version of our demo setup to start building your website.

It's very important to take note that the quick setup must NOT be used on an existing site. We can't stress this point enough. If you use this on a existing site you will lose all of your content, menus, etc. This is intended for a new install, using our General Quick Installer only. We will not be held responsible if you ignore this warning.

Download all the necessary files:

Before you install anything, it's recommended that you download all the necessary files and put them all together in a folder on your computer for easy access later.

Installation steps:

  1. Install Joomla! using Morph's General Quick Installer

    Start off by installing Joomla using the Quick Installer. You can read full step-by-step instructions (and a video) to take you through the installation process.

  2. Install Configurator, Morph and the themelet you downloaded

    Now that Joomla! is successfully installed, you can proceed with installing Morph. If this is your first time, we recommend you go through the comprehensive step-by-step tutorial (and video). Once the installation is completed, click the "Launch Configurator" link at the end.

  3. Install the demo setup & themelet assets

    In Configurator, go to the Tools > Universal Installer tab. The first option to select is the "Upload Themelet Assets", select the assets file you downloaded and click "Upload and install". Once thats done, select the "Install demo content" ([themelet-name]-demo-setup.sql) install option and again, select the demo setup file you downloaded and click "Upload and install".

  4. Extract and copy the demo images

    In this last step you will extract the "demo images" archive that you downloaded earlier, then move the contents of the zip to your "[joomla site root]/images/stories/" folder.

  5. Voila! It really is that easy ;)

    Once you have completed the above steps, your new Joomla site should look just like the online demo. If you get stuck at any stage of these steps, don't hestitate to create a post on the forums and someone from the team will happily assist you.


2. Getting setup using Joomla's installer and sample content

So you didn't want to use the quick installer? If you prefer to use the Joomla installer with sample content, then this is just fine, the steps are a little different. There are however a lot more manual steps to do if you want to get your website looking like the demo.

This process is very similar to the previous step which used our quick installer, however, instead of the automatic quick setup file which does all of the work for you, you have to do a lot of the steps manually.

Download all the necessary files:

Before you install anything, it's recommended that you download all the necessary files and put them all together in a folder on your computer for easy access later.

Installation steps:

  1. Install Joomla! using the Joomla Installer

    Start off by installing Joomla using the Joomla Installer you just downloaded from the Joomla website.

    If you are new to Joomla and have never installed it before. Please take a look at the the official Joomla installation guide and a "How To" video, which covers everything you need to know about installing Joomla

  2. Install Configurator, Morph and the themelet you downloaded

    Now that Joomla! is successfully installed, you can proceed with installing Morph. If this is your first time, we recommend you go through the comprehensive step-by-step tutorial (and video). Once the installation is completed, click the "Launch Configurator" link at the end.

  3. Install themelet assets

    In Configurator, go to the Tools > Universal Installer tab. The first option to select is the "Upload Themelet Assets", select the assets file you downloaded and click "Upload and install". This will upload the themelets logo, backgrounds and other assets to the assets folder.

  4. Extract and copy the demo images

    This step is only needed if you are setting up your website to look identical to the demo and use the images you see in the demo (if available) on your website. In this last step you will extract the "demo images" archive that you downloaded earlier, then move the contents of the zip to your "[joomla site root]/images/stories/" folder.

  5. Move onto next section: "3. Installing on an existing website"

    Once you have completed the above steps, there will still a fair amount of manual steps you need to complete for anything on the themelet demo that you want to implement on your website. The section "Installing on an existing website" covers all of the manual steps.


3. Installing on an existing website

If you are installing Mocha on an existing site (or using Joomla's standard installer and not our quick installer), you will unfortunately need to go through the manual process of setting up any elements you see on the demo you want to replicate. Below are the steps needed to get your site setup section by section.

Installation steps:

Follow steps 2 - 5 above. You can skip the first step which is Installing Joomla because you already have a Joomla install if you are following this guide and want to setup on an existing Joomla website.

The remainder of this guide will show you how to manually setup the different parts of the themelet demo. This will be done by explaining how to setup each Joomla module position or Morph building block manually. Building blocks in Morph are the different sections within which the module positions load. See the morph blocks demo for more details.

Setting up the blocks manually:

to be continued....

Do you think this help article can be improved?

Our goal is to make Morph's documentation as easy and simple to use as possible and if you feel there is anything we can do to improve, whether updates / refinements to the content or how everything is structured, please let us know! We really do value all of the feedback we get and will do everything possible to ensure that the documentation is relevant and useful to you getting up and running with Morph!

Back to Top