CSS toolkit from Twitter for use as a WordPress theme
PHP CSS JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
css
ico
img
includes
js
lang
.gitignore
404.php
README.md
archive.php
author.php
comments.php
footer.php
functions.php
gpl-3.0.txt
header.php
index.php
page-blog.php
page-componentsguide.php
page-full-width.php
page-home.php
page-jsguide.php
page-scaffoldingguide.php
page-styleguide.php
page.php
readme.txt
rtl.css
screenshot.png
search.php
sidebar-blog.php
sidebar.php
single.php
style.css

README.md

Bootstrapwp - TWITTER BOOTSTRAP 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 style guide at: http://bootstrapwp.rachelbaker.me/style-guide/

View the javascript guide at: http://bootstrapwp.rachelbaker.me/javascript-guide/

Usage

Download the BootstrapWP theme, and install to your WordPress site.

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

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.

Getting Started

Create a page that uses the template Hero Homepage Template, then under Settings->Reading set your site to use a static front page selecting your new page. Add content to the three "Home" widget areas under Appearances->Widgets.

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

Bug tracker

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

##v.90 Changelog (still baking)

The goals of this release are:

  1. Add Theme Options Screen
  2. Fix Custom Walker Menu PHP errors
  3. Fix Automatic Thumbnail PHP errors
  4. Remove any unnecessary theme files
  5. Update styles and scripts to Bootstrap 2.10 dev branch

Archive.php

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

Author.php

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

Class-bootstrapwp-walker-nav_menu.php

  • Extending Walker_Nav_Menu to modify class assigned to submenu ul element.

Footer.php

  • Cleaned up ending div tags

Functions.php

  • Fixed bootstrapwp_autoset_featured_img() function to return if there is no image set, clearing debug errors.
  • Removed the post hooks for bootstrap_autoset_featured_img() function to clear debug errors.
  • Added bootstrapwp_post_thumbnail_check() function to check if the post displayed in the loop has a post thumbnail already.
  • Removed Custom Walker class from file and replaced with external include call for file 'includes/class-bootstrap_walker_nav_menu.php'.

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.

##v.87 of BootstrapWP - Released June 4, 2012

Release Highlights:

  1. Switched to using the Less files instead of CSS
  2. Improved navigation submenu dropdown implementation with custom Walker
  3. Updated styles and scripts to Bootstrap 2.04 release
  4. Switched to using bootstrap.js file instead of the separate .js files

Download

###Full Changelog

Functions.php

  • Edited bootstrapwp_css_loader() function to use new /less/bootstrapwp.css generated from Less file compilation and removed references to previously used css files
  • Edited bootstrapwp_js_loader() function to include minified and minified bootstrap.min.js file
  • Edited bootstrapwp_js_loader() function to include /js/bootstrapwp.demo.js file containing all the extra JavaScript needed to enable the functionality of demos
  • Added new walker Bootstrap_Walker_Nav_Menu class to assign "dropdown-menu" class to navigation sub-menus

Style.css

  • Removed content because it this file is not loaded via bootstrapwp_css_loader()
  • Added note to add custom updates to the less/bswp-custom.less file to safely retain the ability to update the less files with future versions of Bootstrap or BootstrapWP
  • Bumped version to .87

Header.php

  • Edited wp_nav_menu() call array to add walker => new bootstrapwp_walker_nav_menu() parameter
  • Removed extraneous commented line from wp_nav_menu() function call

Footer.php

  • Removed all Javascript and moved to new js/bootstrapwp.demo.js file

Page-home.php

  • Created file to be static homepage template that loads 3 widget areas (previously was index.php)

Index.php

  • Edited file to be standard blog homepage - and moved previous template content to new page-home.php file

JS Folder

  • Removed the individual .js files and replaced with single compiled bootstrap.min.js file
  • Added bootstrap.js (pre-minified version of bootstrap.min.js) file for reference
  • Added bootstrapwp.demo.js file which houses code is used to power all the JavaScript demos and examples for BootstrapWP
  • Added folder for google-code-prettify js and css files to style reference and documentation template files.

CSS Folder

  • Removed folder entirely because main style file is compiled less file located at less/bootstrapwp.css

LESS Folder

  • Updated LESS files from Twitter Bootstrap 2.04 branch
  • Added bswp-docs.less file to pull in styles to allow doc pages to format correctly
  • Added note to use bswp-custom.less file for any custom additions to allow for easy updating of styles.
  • Added style fix for top positioning of scrollspy submenu to less/bswp-overrides.less

IMG Folder

  • Updated glyph icons with new set included in Bootstrap 2.04

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

Jacob Thornton