Wordless’s documentation

Introduction

Wordless is an opinionated WordPress plugin + starter theme that dramatically speeds up and enhances your custom theme creation. Some of its features are:

• A structured, organized and clean theme organization
• Scaffold a new theme directly within wp-cli
• Write PHP templates with PUG templating language
• Write CSS stylesheets using the awesome SCSS syntax
• Write Javascript logic in ES2015
• A growing set of handy and documented PHP helper functions ready to be used within your views
• Preconfigured support to MailHog mail-catcher.
• Development workflow backed by WebPack, BrowserSync (with live reload), WP-CLI, Yarn. All the standards you already know, all the customizations you may need.

Wordless is a micro-framework for custom themes development. Thus is a product intended for developers.

A compiled Wordless theme will run on any standard Wordpress installation.

Wordless does not alter any core functionality, thus it is compatible with reasonably any generic plugin.

Table of Contents

Installation

• Prerequisites
• Wordless gem
• Manual installation
  • Additional prerequisites
  • Steps

Usage and structure

• Theme anatomy
• Routing
• Rendering PUG
  • Layouts
  • Templates
  • Partials
  • Components
    • Arguments validation
• SCSS and JS
  • The Fast Way
  • A real explanation
    • Custom assets
    • node_modules
• PHP Helpers
• Initializers
• Locale files
• Filters
  • wordless_pug_configuration
  • wordless_acf_gutenberg_blocks_views_path
• CLI
• Test Suite
  • Quick start
  • Where are test configurations?
  • How should I write tests?
    • Factory template
  • CI

Build and deployment

• Intro
• Development build
• Production build
  • Release signature
  • PHUG optimizer
• Deploy

Development stack

• Intro
• Nodejs
  • Version
  • NVM
• Development environment
  • YARN
  • Foreman
  • wp server
  • BrowserSync
  • MailHog
  • Debug in VSCode
• Code compilation
  • PHUG
    • Who compiles PUG?
  • JS and SCSS
    • Paths
    • Inclusion of compiled files
    • Multiple “entries”
    • Browserslist
    • Stylelint

Appendix

• Using plain PHP templates
  • PHP render helpers
    • render_view()
    • render_partial()
    • Layouts

TODOs

A list of known bugs, wip and improvements this documentation needs

Todo

Ooook, but we need to be a bit more exhaustive and clear about the fact that once the theme is built, we can really just scp it to a server.

(The original entry is located in /home/docs/checkouts/readthedocs.org/user_builds/wordless/checkouts/latest/rtfm/source/_pages/build/deploy.rst, line 11.)

Todo

This page is orphan: it’s not listed in any navigation

(The original entry is located in /home/docs/checkouts/readthedocs.org/user_builds/wordless/checkouts/latest/rtfm/source/_pages/usage/acf_gutenberg_blocks.rst, line 57.)

Todo

There is a note with a ref to wordless_acf_gutenberg_blocks_views_path but the ref apparently does not exists

(The original entry is located in /home/docs/checkouts/readthedocs.org/user_builds/wordless/checkouts/latest/rtfm/source/_pages/usage/acf_gutenberg_blocks.rst, line 60.)

Todo

Please find me a home and delete me

(The original entry is located in /home/docs/checkouts/readthedocs.org/user_builds/wordless/checkouts/latest/rtfm/source/_pages/usage/build.rst, line 1.)

Todo

wordless_component_validation_exception

(The original entry is located in /home/docs/checkouts/readthedocs.org/user_builds/wordless/checkouts/latest/rtfm/source/_pages/usage/filters.rst, line 64.)

Todo

Page Template Wordpress’ feature has to be updated on GitHub in order to reflect new PUG templating practices

(The original entry is located in /home/docs/checkouts/readthedocs.org/user_builds/wordless/checkouts/latest/rtfm/source/_pages/usage/routing.rst, line 27.)