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
Holger 803759abc4 Update README.md 2016-04-29 15:31:03 +02: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 Update README.md 2016-04-29 15:31:03 +02: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

Basically I like the _s WordPress Starter Theme from Automattic and the grid Framework Bootstrap. Additionally I´am a huge SASS fan. Why don´t combine all these three things into a solid WordPress Theme Framework? That´s what UnderStrap is (or will be...)

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

Basic Features

  • Combines the _s WordPress Starter Theme PHP/JS files and Bootstrap´s HTML/CSS/JS
  • Comes with Bootstrap (3.3.6) SASS source files and additional scss files. Nicely sorted and ready to add your own variables/customize the Bootstrap variables.
  • Uses a single and minified CSS file for all the basic stuff
  • Font Awesome Icon Font integrated (V 4.5.0): http://fortawesome.github.io/Font-Awesome/
  • Comes with extra slider script - By owl.carousel (V 2.0.0-beta.2.4): http://www.owlcarousel.owlgraphic.com/
  • Simple RTL file
  • Jetpack ready
  • WooCommerce support
  • Child Theme ready (A basic starter Child Theme will be released in the future as a separate Repository)
  • Translation ready

Starter Theme + HTML Framework = WordPress Theme Framework

The _s theme is a good starting point to develope a WordPress theme. But it is "just" a raw starter theme. Means it outputs all the WordPress stuff correctly but without any layout or design. Why don´t 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 SCSS files?

Some basics about the SCSS and CSS files comes with UnderStrap:

  • The theme itself uses the style.css in the root directory just to identify the theme inside of WordPress. The file is not loaded by the theme and did not include any styles

  • The theme.css file in /css/ subdirectory provides all styles. It is composed by five different SCSS sets and one variables file from /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
    
  • Don´t edit the files no. 2-4 files/filesets or you aren´t able to update it without overwriting your own work!

  • Your design goes into: /sass/theme directory. Add your styles to the theme.scss file and your variables to the _theme_variables.scss. Or add other scss files into it and @import it into 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 frontpage 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