Setup and Installation
Unlike other Drupal themes Kalatheme requires some other modules to work properly. Please verify you have the following before proceeding with installation. If you fail to do as Kalatheme has requested it will bug you about it until the ending of the world.
- Libraries API 2.1+
- Panels 3.3+
- Views 3.x
- JQuery Update 2.x (with JQuery version set to 1.7+)
- PHP 5.3+
- Optional but highly recommended: Panopoly Theme.
- Optional: A custom Bootstrap library.
The easiest way to satisfy all of these requirements is to just start with Panopoly on Pantheon as seen here.
Some people also having troubles using the Kalacustomize plugin were helped by Patch #5 here: #2024441: Fatal error undefined function panels_plugin_get_function when doing #ajax on pane style form which was rolled against Panels 3.3+41-dev.
UPDATE: This patch is now in the latest dev version of CTools/Panels.
Our magical quest to install Kalatheme will begin as it would for any other theme: using the Drupal Installing Modules and Themes Guide. After you have followed the above and installed your theme you should proceed to the Appearances page where you MUST ENABLE IT AND SET IT AS THE DEFAULT THEME as well.
After you enable Kalatheme it is likely you will be blinded by its immense and compelling beauty. What's that? It looks horrible? Never fear! All you need to do is set up kalatheme by going into the theme settings. You can also do this part with drush.
Currently the setup workflow is pretty stable when starting from Pantheon or Kalabox/Kalastack using the Panopoly distro.
In the settings you can easily build a Kalatheme subtheme and pair it with either default Bootstrap, Bootswatch or a Custom Bootstrap Library. Kalatheme also has limited support for third party Bootstrap libraries such as from WrapBootstrap. If you are going to try out a custom or third party library it may be helpful to get your read on here before attempting. You may also optionally pull Font Awesome into your subtheme.
If you want Kalatheme to install and enable these things for you automatically please make sure your webserver is configured properly. If not Kalatheme will simply give you an archive of goodies that you will then need to do something with.
If you have no idea what any of the above is, you really just need to fill out the settings form like below--pick a bootstrap library, add Font Awesome if you like, name your subtheme, hit Build and enable subtheme, and voila!
Note: If you are using Pantheon, kalatheme will ask you to switch your connection mode to SFTP to complete the subtheme generation. You should take heed! If you are already in SFTP, this friendly message will still appear, but you don't need to do anything.
After enabling your new subtheme you will notice that things are styled again. At this point it is best to proceed to Using Kalatheme and Best Practices.
