The STI theme for the EPFL WordPress project
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
css [css] All Alex's customization into scss Oct 5, 2018
devsupport Improve workflow for PHP-side compiled assets (i.e. the megamenu CSS) Jan 31, 2018
fonts Remove unused fonts and their CSS hooks Feb 12, 2018
global-templates Remove sidebar checks left and right (pun intended) Apr 11, 2018
img [feat] 404 page that actually invite the visitor to continue his brow… Nov 5, 2018
inc Materials Science -> Materials Science and Engineering Nov 12, 2018
js Z-index-clean carousel transitions with margin-left May 7, 2018
languages Materials Science -> Materials Science and Engineering Nov 12, 2018
loop-templates The loop template for archive (w/ categorized posts) Oct 16, 2018
newsletter-theme Off with the filtering / grouping by language altogether Aug 30, 2018
page-templates [WIP] cluster page Sep 3, 2018
sass Thanks to @dalgetty, this fixes #101 Nov 19, 2018
tribe-events [debug] inline comment to find out template(s) in use Sep 3, 2018
widgets Update Google API key (see #130) Nov 20, 2018
woocommerce understrap -> EPFL STI Oct 30, 2017
wp-admin Generalize the AJAX code (PHP and JS) to support multiple apps Apr 12, 2018
.gitignore [igm] please ignore translation swp Sep 14, 2018
.jscsrc added js rulesets Jan 26, 2017
.jshintignore added js rulesets Jan 26, 2017
.travis.yml understrap -> EPFL STI Oct 30, 2017
404.php [feat] 404 page that actually invite the visitor to continue his brow… Nov 5, 2018
CHANGELOG.md understrap -> EPFL STI Oct 30, 2017
README.md Fix: missing backtick Dec 20, 2017
archive.php New template for archives (which include categories) Oct 16, 2018
author.php [dbg] New comments in templates Oct 16, 2018
codesniffer.ruleset.xml Update codesniffer.ruleset.xml Aug 14, 2017
comments.php [dbg] New comments in templates Oct 16, 2018
footer.php [dbg] New comments in templates Oct 16, 2018
front-page.php Update obsolete comment Jan 3, 2018
functions.php Merge remote-tracking branch 'origin/John/anewhope' Mar 21, 2018
gulpfile.js Doc touchup Apr 12, 2018
gulpfile.js.local.example Improve workflow for PHP-side compiled assets (i.e. the megamenu CSS) Jan 31, 2018
header.php [OCD] spaces and line break Nov 19, 2018
index.php Remove sidebar checks left and right (pun intended) Apr 11, 2018
package-lock.json [update] node modules Nov 4, 2018
package.json [update] node modules Nov 4, 2018
page.php [debug] inline comment to find out template(s) in use Sep 3, 2018
readme.txt Overhaul of readme.txt Nov 17, 2017
screenshot.png Well, things have changed... Feb 6, 2018
search.php Rewriting of the search result template Sep 4, 2018
searchform.php [feat] 404 page that actually invite the visitor to continue his brow… Nov 5, 2018
single.php [debug] inline comment to find out template(s) in use Sep 3, 2018
style.css understrap -> EPFL STI Oct 30, 2017
woocommerce.php Remove sidebar checks left and right (pun intended) Apr 11, 2018

README.md

EPFL STI WordPress Theme Framework

Based on UnderStrap — Bootstrap 4, jQuery, child-theme-friendly, Jetpack, WooCommerce, i18n.

License

Like UnderStrap, the EPFL-STI theme is released under the terms of the GPL version 2 or (at your option) any later version.

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

Installation

  • Download folder from GitHub
  • Upload it into your WordPress installation subfolder here: wp-content/themes/epfl-sti
  • Run a terminal, cd to the wp-content/themes/epfl-sti and type npm install to build all the things
  • Login to your WordPress backend
  • Go to Appearance → Themes
  • Activate the EPFL-STI theme

Plugins

polylang

  1. Install Polylang
  2. Change the language full name to get the FR / EN (https://polylang.pro/doc/configure-the-languages/#full-name)

Development

Installing Dependencies

  • Make sure you have installed Node.js and npm on your computer globally
  • Then open your terminal and browse to the location of your UnderStrap copy
  • Run: $ npm install

Running

  1. Get WordPress running and note down the URL for step 5
  2. Add devsupport/browser-sync.crt to your browser's or operating system's trusted certificate store (optional but recommended in order to debug with Chrome)
  3. Make sure you have installed Node.js on your computer globally
  4. Then open your terminal and browse to the location of your UnderStrap copy
  5. Run e.g.: $ npm start -- --url=https://localhost/sti --browser=chrome
    💡 For Mac OS X, use --browser="Google Chrome" instead.

Directory layout

  • Files read by WordPress directly: index.php, style.css (the browser never sees that one)
  • Serving directories: css/, js/ — may contain source files, as well as files generated by Gulp
  • Source files for the client (non-serving-state; must be processed with Gulp): src/, sass/
  • PHP templates for the overall site layout: header.php, footer.php
  • PHP templates for specific pages: tribe-events/single-event.php, loop-templates/*.php

SCSS basics

The /css/theme.css and its minified little brother /css/theme.min.css file(s) provides most of the styles. It is composed of five different SCSS sets and one variable file at /sass/theme.scss. Read the comments there for a quick orientation session. Add your designs to /sass/theme/_theme.scss and your variables to /sass/theme/_theme_variables.scss.

Licenses & Credits