This repository has been archived on 2020-05-08. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Kyle Morgan 57ae134650 Cleaning up the README 2016-05-02 09:41:24 -06:00
css Resorting BS4 assets 2016-04-29 11:23:13 +02:00
fonts sunday mornin coffee 2016-03-20 09:49:34 +01:00
inc Mini release 0.4.2 2016-04-29 11:34:47 +02:00
js Resorting BS4 assets 2016-04-29 11:23:13 +02:00
languages fixed german translation 2016-04-15 17:48:36 +02:00
loop-templates Adding custom search form with Bootstrap markup 2016-03-03 20:38:28 +01:00
page-templates Moving Loops to subdirectory 2016-01-22 13:59:47 +01:00
sass Resorting BS4 assets 2016-04-29 11:23:13 +02:00
src Resorting BS4 assets 2016-04-29 11:23:13 +02:00
widget-templates adding missing .row classes 2016-03-09 10:16:22 +01:00
.gitignore updating package.json 2016-02-15 09:14:43 +01:00
404.php adding missing .row classes 2016-03-09 10:16:22 +01:00
README.md Cleaning up the README 2016-05-02 09:41:24 -06:00
archive.php adding missing .row classes 2016-03-09 10:16:22 +01:00
bower.json Mini release 0.4.2 2016-04-29 11:34:47 +02:00
comment-form.php Adding Bootstrap markup and custom comment form 2014-12-11 17:41:11 +01:00
comments.php solved issue #14 thx to @Thomas-A-Reinert 2016-03-22 17:39:57 +01:00
footer.php fixing footer layout 2016-03-09 10:21:11 +01:00
functions.php add woocommerce support declaration 2015-09-09 10:58:25 +02:00
gulpfile.js Resorting BS4 assets 2016-04-29 11:23:13 +02:00
header.php bs4 fine tuning 2016-04-26 14:05:02 +02:00
index.php adding missing .row classes 2016-03-09 10:16:22 +01:00
package.json Mini release 0.4.2 2016-04-29 11:34:47 +02:00
page.php adding missing .row classes 2016-03-09 10:16:22 +01:00
readme.txt Preparing pre-release for 0.3.8 2016-03-09 10:37:15 +01:00
screenshot.png adding new screenshot to reflect layout changes 2016-04-15 09:04:42 +02:00
search.php adding missing .row classes 2016-03-09 10:16:22 +01:00
searchform.php Adding custom search form with Bootstrap markup 2016-03-03 20:38:28 +01:00
sidebar.php streamline comments 2016-01-22 14:02:32 +01:00
single.php fixing typo in closing tag 2016-03-10 13:22:28 +01:00
sticky.php adding missing .row classes 2016-03-09 10:16:22 +01:00
style.css Mini release 0.4.2 2016-04-29 11:34:47 +02:00
woocommerce.php streamline comments 2016-01-22 14:02:32 +01:00

README.md

Start talking: Gitter

UnderStrap WordPress Theme Framework

Website: http://understrap.com

Child Theme Project: https://github.com/holger1411/understrap-child

Changelog

        - **0.4.0 Apr. 29th 2016 **
               - Switching from Bootstrap 3 to Bootstrap 4
               - Adding BrowserSync to gulpfile (again thx to @dvlopes)
               - Preparing the navbar markup so that the current version will work with Bootstrap 3 AND 4
               - Adding "gulp scripts" command - This uglifies and minifies all JS files (except jQuery...) into one single JS file called theme.min.js
               - Updating Gulpfile - now "gulp copy-assets" command copies all files from dependency folders into mid-layer folder called "/src"
               - Load jQuery again as extra script instead of concat it into on single file. After some problems with WooCommerce and other plugins
               - Checking WordPress 4.5 compatibility
               - Updating language template
               - Adding Brazilian Portuguese (pt-BR) translation (thx to @dvlopes).

        - **0.3.8 Mar. 9th 2016 **
               - Adding footer widget area
               - Adjust Bootstrap markup for searchform and search widget


        - **0.3.7 Jan. 8th 2016**
               - Cleanup for submitting to WordPress.org theme repository:
                    - Fixing sticky post problem
                    - Fixing skip-to-content link
                    - re-activating the admin bar
                    - adding readme.txt
                    - Fixing missing translation strings in comments template


        - **0.3.6 Jan. 4th 2016**
               - Cleanup
               - Updating dependencies
               - Upgrade to Bootstrap 3.3.6 and Font Awesome 4.5.0


        - **0.3.4 SEP. 9th 2015**
               - Adding basic WooCommerce support
               - Cleanup for submitting to wordpress.org
               - Removing _s SASS ... no need for basic styling. Thats Bootstrap´s job.


        - **0.3.1 AUG. 12th 2015**
               - Adding bower dependency manager and replacing GRUNT taskrunner with GULP

        - **0.3.0 Mar. 23th 2015**
               - Streamlining some code, adding extra "sticky" area (sticky posts above the main content area inside an extra loop). Fixing some child theme issues (now its really child theme ready...really...trust me...)

        - **0.2.9 Mar. 10th 2015**
               - Adding a new theme customizer option. It lets you add a code snippet right before the closing </body> tag.
               For example for Google Analytics, Google Tag Mananger, Pingdom etc. Just copy and past your code to the input field and save the setting.
               So you don´t have to edit the theme source file´s directly and your theme stay´s updateable

        - **0.2.8 Feb. 6th 2015**
               - Adding Grunt and Grunt SASS task


        - **0.2.7 Jan. 26th 2015**
               - Adding some basic theme option for the build-in slider script

        - **0.2.6 Dec. 28th 2014**
                - CLean up


        - **0.2 Dec. 22th 2014**
                - Adding Jasny Off-Canvas nav and Owl.Carousel Slider script
                - Enqueue scipts and styled dynamically

        - **0.1 Dec. 10th 2014 - First commit**

About

Im a huge fan of Underscores, Bootstrap, and Sass. Why not combine these into a solid WordPress Theme Framework? Thats what UnderStrap is (or will be…)

At the moment, UnderStrap is in a very early stage. But if you want, feel free to use it for your own WordPress theme!

Basic Features

  • Combines Underscores PHP/JS files and Bootstraps HTML/CSS/JS.
  • Comes with Bootstrap (v3.3.6) Sass source files and additional .scss files. Nicely sorted and ready to add your own variables and customize the Bootstrap variables.
  • Uses a single and minified CSS file for all the basic stuff.
  • Font Awesome integration (v4.5.0)
  • Comes with extra slider script by Owl Carousel (v2.0.0-beta.2.4)
  • Simple RTL file.
  • Jetpack ready.
  • WooCommerce support.
  • Child Theme ready.
  • Translation ready.

Starter Theme + HTML Framework = WordPress Theme Framework

The _s theme is a good starting point to develop a WordPress theme. But it is “just” a raw starter theme. That means it outputs all the WordPress stuff correctly but without any layout or design. Why not add a well known and supported layout framework to have a solid, clean and responsive foundation? Thats where Bootstrap comes in.

Confused by All the CSS and Sass Files?

Some basics about the Sass and CSS files that come with UnderStrap:

  • The theme itself uses the /style.cssfile just to identify the theme inside of WordPress. The file is not loaded by the theme and does not include any styles.

  • The /css/theme.css file provides all styles. It is composed of five different SCSS sets and one variable file at /sass/theme.scss:

                - 1 "theme/theme_variables";  // <--------- Add your variables into this file. Also add variables to overwrite Bootstrap or UnderStrap variables here
                - 2 "../src/bootstrap-sass/assets/stylesheets/bootstrap";  // <--------- All the Bootstrap stuff - Don´t edit this!
                - 3 "understrap/understrap"; // <--------- Some basic WordPress stylings and needed styles to combine Boostrap and Underscores
                - 4 "../src/fontawesome/scss/font-awesome"; // <--------- Font Awesome Icon styles
    
                // Any additional imported files //
                - 5 "theme/theme";  // <--------- Add your styles into this file
    
  • Dont edit the files no. 2-4 files/filesets or you wont be able to update it without overwriting your own work!

  • Your design goes into: /sass/theme. Add your styles to the /sass/theme/_theme.scss file and your variables to the /sass/theme/_theme_variables.scss. Or add other .scss files into it and @import it into /sass/theme/_theme.scss.

Installation

  • Download the understrap folder
  • Upload it into your WordPress installation subfolder here: /wp-content/themes/
  • Login to your WordPress backend
  • Go to Appearance → Themes
  • Activate the UnderStrap theme

Developing With NPM, Bower, Gulp and SASS and [Browser Sync][1]

Installing Dependencies

  • Make sure you have installed Node.js, Bower, and Browser-Sync on your computer globally
  • Then open your terminal and browse to the location of your UnderStrap copy
  • Run: $ npm install then: $ bower install and finally: $ gulp copy-assets

Running

To work and compile your Sass files on the fly start:

  • $ gulp watch

Or, to run with Browser-Sync:

  • First change the browser-sync options to reflect your environment in the file /gulpfile.js in the beginning of the file:
var browserSyncOptions = {
    proxy: "localhost/theme_test/", // <----- CHANGE HERE
    notify: false
};
  • then run: $ gulp watch-bs

How to Use the Build-In Widget Slider

The front-page slider is widget driven. Simply add more than one widget to widget position “Hero”.

  • Click on Appearance → Widgets.
  • Add two, or more, widgets of any kind to widget area “Hero”.
  • Thats it.

[1] Visit http://browsersync.io for more information on Browser Sync