Skip to content

10degrees/10degrees-base

Repository files navigation

10 Degrees base WordPress theme

The 10 Degrees base WordPress theme is intended as a quick-start for developers and requires configuration before using. It uses a number of concepts from Laravel, and aims to make development more standardised and accessible. Where possible, PSR-2 style guidelines are mandated with a custom ruleset.

  • CSS: SASS preprocessor for CSS
  • JavaScript: ES6 ready
  • PHP: Namespaces and autoloader with many asbtractions and helper functions
  • PHP: base.php wrapper, originally implemented by Sage theme
  • WP CLI block quickstart command

Requirements

  • WordPress >= 5.6
  • PHP >= 7.0
  • Composer
  • Node

Dependencies are managed through Composer and Node. Please ensure both are installed.

Installation

Via Composer

  1. Add "10degrees/10degrees-base": "*" to the require section of your site-wide composer.json.
  2. Run composer install.

Manual install

  1. Download the latest theme release from https://github.com/10degrees/10degrees-base/releases/latest.
  2. Upload zip file to Appearance -> Themes.

Theme Setup

From the theme root folder, run:

  • composer install
    • this will already have run if you have added 10degrees/10degrees-base as part of a site-wide composer-based install. For 10 Degrees developers, this is already included as part of our 10degrees-alpha master install.
  • npm install

Placeholders

Find and replace @textdomain and @theme placeholders in order to set the theme's text domain and name as required.

Compiling assets

Assets are edited in src and compiled to dist. Files are given a cache-busting version when compiled for production only. Use npm run watch and npm run dev when compiling for development. Use npm run production when compiling for production.

Browser support

All modern browsers.