Epfl theme (Wordpress)

• Based on _s theme (underscores)
• Implements the elements styleguide
• Uses shortcodes to display special content served by EPFL APIs.

Requirements

• production build files of elements located in /assets (create a new version if needed)
• composer

How to install

1. Copy (or symlink) the theme in the /wp-content/themes directory of your project
2. Nothing more, you're ready to go! 🚀

Build a new release

Recovering the last version of the styleguide

• Clone element repository git clone git@github.com:epfl-si/elements.git
• Checkout the dist: git checkout dist/frontend && git pull
• Go on wp-theme-2018 repository
• Update the theme with: git pull
  • Copy elements files from elements:dist/frontend to wp-theme-2018 cloned repository (in parent theme folder).
    • Assuming you have both repositories cloned in the same parent directory, you can use following commands:

      rsync -av --progress ./elements/ wp-theme-2018/assets/ 
        --exclude node_modules --exclude .git 
        --exclude 'package.json' --exclude '.nojekyll'
      

• Find the elements version in ./elements/package.json
• Commit the builds git commit -am "New element version $elementversion"
• Push git push
• Here you go, you just updated the styleguide version contained in this theme !

Create a new release

• update the following files:
  • wp-theme-2018/VERSION with the version number
  • wp-theme-2018/style.css with the version number
  • CHANGELOG.md with a description of all the changes since last release
• commit them in a "Bump version" commit git commit -am "Bump version"
• Push git push
• head over this repo on github, on the release tab (or go directly using https://github.com/epfl-si/wp-theme-2018/releases)
• go to Draft a new release
• choose the release number you just changed, insert the changelog informations into the release description
• Publish the release
• congratulation, a new version has been released ! 🎉