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 Könemann f87e49904e update changelog to 0.81 2018-03-07 11:08:50 +01:00
css update changelog to 0.81 2018-03-07 11:08:50 +01:00
fonts update changelog to 0.81 2018-03-07 11:08:50 +01:00
global-templates Update right-sidebar-check.php 2017-11-27 09:03:41 +05:30
inc add function exists check in custom-comments.php 2018-03-05 07:29:00 +01:00
js update changelog to 0.81 2018-03-07 11:08:50 +01:00
languages Merge pull request #571 from asaf147369/patch-1 2018-03-02 17:11:20 +01:00
loop-templates phpcs fixes. 2017-04-15 21:44:32 +09:30
page-templates Fix wrong escaping functions - replacing esc_html() with esc_attr() 2017-06-08 17:54:29 +03:00
sass Enhanced contrast to comply with WCAG 2.0 rules 2018-03-02 23:11:24 +01:00
src Replace Bootstrap 4 Beta 3 with Bootstrap 4 final 2018-01-22 09:09:25 +01:00
woocommerce Updated the markup for input groups according to BS 4 changes 2018-03-03 19:09:49 +00:00
.gitignore added composer.json 2017-06-12 15:14:14 -04:00
.jscsrc ignore testing of vendor files 2018-01-27 17:38:17 -06:00
.jshintignore ignore testing of vendor files 2018-01-27 17:38:17 -06:00
.travis.yml ignore testing of vendor files 2018-01-27 17:38:17 -06:00
404.php Fixing this issue: https://github.com/holger1411/understrap/issues/392 2017-08-22 09:04:58 +02:00
CHANGELOG.md update changelog to 0.81 2018-03-07 11:08:50 +01:00
README.md switch back to javascript highlighting (ick) 2018-02-19 21:48:04 -06:00
archive.php Update archive.php 2017-11-27 09:05:28 +05:30
author.php Merge pull request #471 from Vishal-Deshpande/master 2017-12-22 07:35:30 +01:00
bower.json Preparing 0.8.0 update 2018-01-22 09:16:57 +01:00
codesniffer.ruleset.xml Update codesniffer.ruleset.xml 2017-08-14 17:30:16 +03:00
comments.php Update comments.php 2017-12-28 14:35:34 +05:30
composer.json added project url 2017-06-12 15:19:29 -04:00
footer.php Markup alignments and changeling update for 0.6.3 update 2017-08-14 13:31:10 +02:00
functions.php Cleanup functions.php 2017-12-11 08:44:03 +01:00
gulpconfig.json wrapping imagemin in a watcher to insure it finishes 2018-02-19 21:29:16 -06:00
gulpfile.js Update gulpfile.js 2018-03-07 10:01:24 +01:00
header.php Fixes invalid code due to WP´s itemprop insertion 2018-03-02 17:27:12 +01:00
index.php See https://github.com/holger1411/understrap/issues/565 2018-02-22 18:27:55 +01:00
package.json update changelog to 0.81 2018-03-07 11:08:50 +01:00
page.php Update page.php 2017-11-27 09:07:41 +05:30
readme.txt Fixing sanitizing, escaping and prefix´s issues 2017-12-06 10:20:33 +01:00
screenshot.png adding new screenshot.png 2017-12-29 10:48:48 +01:00
search.php Update search.php 2017-11-27 09:40:48 +05:30
searchform.php Updated the markup for input groups according to BS 4 changes 2018-03-03 19:09:49 +00:00
sidebar-footerfull.php Fix wrong escaping functions - replacing esc_html() with esc_attr() 2017-06-08 17:54:29 +03:00
sidebar-hero.php Removing span duplicate 2017-12-08 14:29:57 +01:00
sidebar-left.php escape variables from potential unsecure input 2016-11-19 19:43:22 +02:00
sidebar-right.php escape variables from potential unsecure input 2016-11-19 19:43:22 +02:00
sidebar-statichero.php Fix wrong escaping functions - replacing esc_html() with esc_attr() 2017-06-08 17:54:29 +03:00
sidebar.php root files code format 2016-11-21 20:47:05 +02:00
single.php Update single.php 2017-11-27 09:41:45 +05:30
style.css update changelog to 0.81 2018-03-07 11:08:50 +01:00
woocommerce.php Update woocommerce.php 2017-11-27 09:42:15 +05:30

README.md

Travis build: Build Status | Start talking: Gitter

See: Official Demo | Read: Official Docs Page

UnderStrap WordPress Theme Framework

Website: https://understrap.com

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

About

Im a huge fan of Underscores, Bootstrap, and Sass. Why not combine these into a solid WordPress Theme Framework? Thats what UnderStrap is. You can use it as starter theme and build your own theme on top of it. Or you use it as parent theme and create your own child theme for UnderStrap.

License

UnderStrap WordPress Theme, Copyright 2013-2017 Holger Koenemann UnderStrap is distributed under the terms of the GNU GPL version 2

http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html

Changelog

See changelog

Basic Features

  • Combines Underscores PHP/JS files and Bootstraps HTML/CSS/JS.
  • Comes with Bootstrap (v4) 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.7.0)
  • Jetpack ready.
  • WooCommerce support.
  • Contact Form 7 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 and its minified little brother /css/theme.min.css file(s) 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

Classic install

  • Download the understrap folder from GitHub or from https://understrap.com
  • IMPORTANT: If you download it from GitHub make sure you rename the "understrap-master.zip" file just to "understrap.zip" or you might have problems using child themes !!
  • Upload it into your WordPress installation subfolder here: /wp-content/themes/
  • Login to your WordPress backend
  • Go to Appearance → Themes
  • Activate the UnderStrap theme

npm install

  • Open your terminal
  • Change to the directory where you want to add UnderStrap
  • Type npm install understrap

WordPress.org install

  • Open your WordPress backend
  • Click on "Appearance -> Themes"
  • Hit the "Add new" button
  • Search for "UnderStrap"
  • Hit the "install" button
  • Activate the theme

Developing With npm, Gulp and SASS and [Browser Sync][1]

Installing Dependencies

  • Make sure you have installed Node.js and Browser-Sync* (* optional, if you wanna use it) on your computer globally
  • Then open your terminal and browse to the location of your UnderStrap copy
  • Run: $ npm install

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 /gulpconfig.json in the beginning of the file:
{
    "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.

RTL styles?

Just add a new file to the themes root folder called rtl.css. Add all alignments to this file according to this description: https://codex.wordpress.org/Right_to_Left_Language_Support

Page Templates

Blank Template

The blank.php template is useful when working with various page builders and can be used as a starting blank canvas.

Empty Template

The empty.php template displays a header and a footer only. A good starting point for landing pages.

Full Width Template

The fullwidthpage.php template has full width layout without a sidebar.

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

Licenses & Credits

Analytics