This Omega 3.x Doc page is under construction!
The Non-Drush Method
Acquiring and Installing Omega into your Drupal Site
Note: You can also use Omega Tools module which gives you a wizard for creating a subtheme through Drupal's UI.
- Download Omega
- unzip it (Stuffit or 7-Zip or similar)
- Place the Omega folder & its contents into your Drupal site's
- Choose your Starterkit and Copy:
Choose Omega as it will cover 99% of use-cases. Only choose Alpha if you know what you are doing. Use either the HTML5 or XHTML starterkit to create your custom theme. Copy the starterkit you choose and place it in your
The path to your subtheme should be
If you have a particular requirement for XHTML choose XHTML. Otherwise, HTML5 is a better choice in terms of long-term compatibility with the modern web's changing Browser standards.
Modify your subtheme folder & files
- Rename the starterkit folder name to your preferred subtheme name.
DO NOT use spaces or dashes (-) in your subtheme name, or your subtheme will NOT be recognized.
- Rename your .info file:
Open your subtheme folder and locate the starterkit.info file. Rename this file to the exact name that you used for your subtheme folder. It is imperative that the name of your theme folder and your .info file match, otherwise your theme will not display. See the paths below for example:
- Make the necessary changes to the yoursubtheme.info file
- Open yoursubtheme.info and locate the following lines:
sites/all/themes/mysubthemename & sites/all/themes/mysubthemename/mysubthemename.info
- name = Replace with yoursubthemename
- description = Replace with a your subtheme description
- hidden = TRUE *** DELETE THIS LINE ***
- starterkit = TRUE *** DELETE THIS LINE ***
In order for your responsive CSS to load correctly you must change the names of the default CSS files. Rename the files found at
/sites/all/themes/mythemename/cssto include your subtheme name. See the example filenames below:
- starterkit-alpha-default.css to mysubthemename-alpha-default.css
Go for it!
You are now ready to begin using your subtheme! Go to admin/appearance and you will find your newly created subtheme. Enable your subtheme only. DO NOT enable the Alpha & Omega Core themes.
The Drush Method
These simplified instructions are valid with omega_tools-7.x-3.x-dev and omega-7.x-3.x-RC1. It is no longer necessary to edit the generated .info file or to rename the generated CSS files. Please update to the latest versions of both prior to proceeding.
Using Drush, the Drupal Shell, makes it very simple to create sub-theme. You will need to download and install the Omega Tools module first (this should be done anyways as Omega Tools has features outside Drush such as theme exporting). Once you have Omega tools and Drush installed and configured perform the following steps:
- From a shell console in your site's root directory type
drush omega-subtheme mythemenamewhere mythemename is the name of your custom theme. Remember, don’t use any dashes or spaces though!
- Once the subtheme is created successfully you will see your new directory under /sites/all/themes/mythemename.
You should find your new theme ready for you to use under the appearances link in your admin menu. It is not necessary to enable the Alpha & Omega Core themes. Enjoy!