sammso / bootstrap-theme

Template to create Liferay portals with a new theme developed using the amazing Twitter Bootstrap framework

Liferay Bootstrap theme

Template to create Liferay portals with a new theme developed using the amazing Twitter Bootstrap framework

About this project

These instructions show you how to get started with bootstrap-theme source tree. Note that these instructions are for developers looking to customize and collaborate with bootstrap-theme itself.

This project contains:

• Bootstrap theme, which includes base CSS, Javascript and HTML for typography, forms, buttons, tables, grids, navigation, and more with responsive design based on latest version Bootstrap 2.3.2.

• Theme templates files customized to use the Bootstrap Base CSS and Components.
• Theme layouttpl files that create the Bootstrap Fluid grid system
• Theme look-and-feel settings

If you like to try a release that has already been built, we recommend that you visit download page at SourceForge and read the Try the Bootstrap theme section below.

Pre-requisites

To develop bootstrap-theme you need:

• Liferay Plugins SDK 6.1 GA 2, command-line-driven development environment for portlets, themes and layout templates.

To start with bootstrap-theme you need:

• Liferay Portal 6.1 CE GA2
• Private Plugin Installer CE The Private Plugin Installer app allows developers and system administrators to hot deploy individual Liferay plugins using the Control Panel.

Developer setup instructions

1. Download this project to themes directory in your Liferay SDK
2. Customize as needed
3. Run ant to deploy the theme

Try the Bootstrap theme

1. Download the Bootstrap theme

2. Install Bootstrap theme (see section Install Bootstrap theme below)

3. Download the Bootstrap site template

   To test Bootstrap theme quickly, we have created a Bootstrap site template, which includes Liferay pages configured with demo web contents to build the Bootstrap site in Liferay: Home, Get started, Scaffolding, Base CSS, Components, JavaScript, Customize

4. Import Bootstrap site template (see section Import Bootstrap site template below)

5. Use Bootstrap site template (see section Use Bootstrap site template below)

Install Bootstrap theme

To install bootstrap-theme-6.1.1.1.war:

1. Go to Control Panel >> Plugins Installation, press tab Plugin Private Installer, then press tab Upload File.

   Note that you can also install it by copying to /deploy directory on your Tomcat server.

2. Go to Control Panel >> Site Templates and press Add button.

   Create the site template for your server, for example Bootstrap Site. It will appear in your Control Panel once created.

Import Bootstrap site template

1. Go to Control Panel >> Site Templates. Locate the target site and press Actions then Import action to load bootstrap-site.lar

   We suggest you activate Deleted missing pages

2. Check the default web content have been imported successfully. To check it, go to Control Panel >> Site Templates, press Actions button and go to View Pages

3. Configure the footer for site pages:

• Control Panel >> Site Templates press Actions button and go to View Pages
• From dockbar select Manage >> Site Content >> Web Content and search Footer__Bootstrap content, then copy its number ID.
• From dockbar select Manage >> Page, select Pages and replace the value of field footer-section-article-id with the ID of your footer web content.
• The footer web content will be visible in all the pages of site template.

Use Bootstrap site template

1. Check the default web content have been imported successfully. To check it, go to Control Panel >> Site Templates, press Actions button and go to View Pages
2. Go to Control Panel >> Sites, press Add button and select the site template named "Bootstrap site"
3. Give a name for your new site and save it

Note your new site has been populated with web contents, documents and media, all copied from the Bootstrap site template.

Bug tracker

Have a bug or a feature request? Please open a new issue. Before opening any issue, please search for existing issues and read the Issue Guidelines, written by Nicolas Gallagher.

Contributing

All contributions will be welcome, just create a pull-request and we will take it in account.

Thanks!

Thanks to

Twitter Bootstrap is a sleek, intuitive, and powerful front-end framework for faster and easier web development, created and maintained by Mark Otto and Jacob Thornton.

Liferay Portal is an enterprise web platform for building business solutions that deliver immediate results and long-term value.

License

Copyright (C) 2013 DISID TECHNOLOGIES S.L.

This work is licensed under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License.

This work is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

To view a copy of this license, visit http://www.gnu.org/copyleft/gpl.html