chirox / bootstrapwp-twitter-bootstrap-for-wordpress

CSS toolkit from Twitter for use as a WordPress theme

BootstrapWP - Bootstrap Theme for WordPress

Bootstrap is a responsive front-end toolkit from Twitter designed to kickstart web development, complete with core HTML, CSS, and JS for grids, type, forms, navigation, and many more components. Now you can use it with WordPress as a solid base to build custom themes quickly and easily.

Download the most-up-to-date theme files: Download .zip file Follow the development: WIP Branch on Github

Demo

You can view a demo of this WordPress theme running the latest development branch code at: http://bootstrapwp.rachelbaker.me/

View the theme's base CSS elements at: http://bootstrapwp.rachelbaker.me/base-css/

View the theme's JavaScript guide at: http://bootstrapwp.rachelbaker.me/javascript/

Usage

Download the BootstrapWP theme, and install on a WordPress local or development site.

This is meant to be a base theme for WordPress custom theme development. Your knowledge of WordPress theme development practices as well as understanding of HTML, CSS/LESS, jQuery and PHP are required.

Getting Started

1. Create a page that uses the template Page - Home Hero, then under Settings->Reading set your site to use a static front page selecting your new page.

2. Add content to the three "Home" widget areas under Appearances->Widgets.

3. Create a menu under Appearances->Menus and assign it be your site's Main Menu.

Customization

Comfortable with LESS?

Check out the /assets/css/less folder where the bootstrapwp.less file is the master complier. The included files compile the bootstrapwp.css file that is located in the /assets/css folder. Important! To safely retain the ability to update the less files with future versions of Bootstrap or BootstrapWP, add all custom edits/changes inside the less/bswp-custom.less file.

Not comfortable with LESS?

You can override the compiled bootstrapwp.css file by adding custom styles to the style.css in the theme's root directory.

Prefer to create a Child Theme?

BootstrapWP is Child Theme compatible. For more information on how to create a Child Theme check out the WordPress Codex.

Bug tracker

Please report all issues on the repo's Issue Tracker. Remember to provide as much information as possible regarding the bug/issue you are reporting so a patch can be released.

Report theme bugs https://github.com/rachelbaker/bootstrapwp-Twitter-Bootstrap-for-WordPress/issues

##v.91 of BootstrapWP ##

Release Highlights:

1. Updated to Bootstrap 2.2.1 scripts and styles
2. Fix Child Theme compatibility
3. Improved file organization with assets and template folders
4. Merged internationalization/translation contributions from santiagogil and zedejose

Assets Folder

• Now contains the following folders: css, js, img, fonts and ico
• Removed assets/css/less/bswp-docs.less file as it is now only loaded on documentation templates.
• Updated all LESS and JS files from Bootstrap 2.2.1

Templates-Documentation Folder

• Holds documentation page templates and related assets
• Updated documentation templates and docs.css file from Bootstrap 2.2.1

Templates-Pages Folder

• Holds theme's page templates
• Changed layout on page-home.php to match hero template
• Removed "jumbotron" class from h1 title on page-blog.php template

404.php

• Removed masthead comment to clean up template file

Archive.php

• Reorganized divs around breadcrumbs

Author.php

• Reorganized divs around breadcrumbs

Footer.php

• Back to top text is now translatable (props @santiagogil)

Functions.php

• Changed paths to CSS and JS files to assets folder
• Corrected text-domain (props @zedejose)
• Added localization support for widgets and excerpt text (props @santiagogil)
• Edited height on bootstrap-medium image size

Header.php

• Updated responsive navbar wrapping to use the button element
• Removed wp-list-pages fallback for custom menu
• Removed div elements for content-wrapper and container at end of file

Index.php

• Removed unnecessary double loop for page title.

Page.php

• Removed '' element wrapping around page title.

Page-blog.php

• Replaced conditional for the_post_thumbnail() with bootstrapwp_autoset_featured_img().

Docs Folder

• Removed entire 'docs' folder to clean up theme files.

IMG Folder

• Removed sub-folder 'example-sites' to clean up theme files.
• Removed sub-folder 'examples' to clean up theme files.
• Updated with new images and icons from Bootstrap 2.1

Copyright and license

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program 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.

You should have received a copy of the GNU General Public License along with this program.  If not, see <http://www.gnu.org/licenses/>.

Thanks to the Original Twitter Bootstrap Authors

Mark Otto

• http://twitter.com/mdo
• http://github.com/markdotto

Jacob Thornton

• http://twitter.com/fat
• http://github.com/fat