Docs

Table of Contents

---

WP DEV:

https://code.davidawindham.com/david/wp

• Composer to In stall phpdotevn, monolog, whoops, wp-cli, phpcodesniffer, wp-coding-standards, and phpcompatibility-wp.
• Run _install.sh & set ENV in .env
• WordPress is installed in the /wp subdirectory as a sub-module
  • cd wp $ git checkout ( branch or tag )
  • wp-content/ –> app/
• wp-cli settings in wp-cli.yml
• /SRDB – ( Search and Replace DB ) $ rm from production
• Other plugins are in .gitmodules.extra and .gitmodules.remote

Git’ing My WordPress Workflow, so i’m machindependent.

---

ca·ve·at git·mptor: do not clone ( build your own )

---

2006 – ( v 0.1.0 ) Modern WordPress workflow ala develop.svn.wordpress.org & https://github.com/koop/develop with an enviroment that’s easy to replicate between machines.

2020 – ( Updated v 0.2.0 ) Inspiration from Develop-Wordpress, Roots, Square-One, & Laravel. Trying to use the smallest dev footprint possible closely matching the WordPress core workflow alongside of a full suite of development tools. Prefer to use Git version of WordPress to enable switching versions quickly. Prefer using Composer for plugins to avoid git submodule hell.

Built With:

WordPress, Node, NPM, Grunt, Composer, Travis CI

Usage

$ git clone git@github.com:windhamdavid/wp.git
$ npm install
$ git submodule update --init --recursive
$ cd wp
$ git fetch --tags && git checkout 5.5.1 /*(WordPress version you'd like)*/
$ cd ..
$ composer update
$ npm run dev 
    /* run _install.sh  
        generates salts/keys 
        cp .env.example to .env
        cp wp-config-sample.php -> wp-config.php
    */
    /* edit you know the drill */

ToDo:

setup tests add rsync have fun

2020 Notes:

Clean up old submodules.

# Remove the submodule entry from .git/config
git submodule deinit -f path/to/submodule

# Remove the submodule directory from the superproject's .git/modules directory
rm -rf .git/modules/path/to/submodule

# Remove the entry in .gitmodules and remove the submodule directory located at path/to/submodule
git rm -f path/to/submodule

path = app/themes/_s url = https://github.com/Automattic/_s.git

path = app/plugins/vip-scanner url = https://github.com/Automattic/vip-scanner.git

path = app/plugins/developer url = https://github.com/Automattic/developer.git

path = app/plugins/wp-redis-cache url = https://github.com/windhamdavid/wp-redis-cache.git

path = app/plugins/wp-debug-bar url = https://github.com/brandwaffle/wp-debug-bar.git

path = app/plugins/debug-bar-slow-actions url = https://github.com/kovshenin/debug-bar-slow-actions.git

path = app/plugins/WP-API url = https://github.com/WP-API/WP-API.git

Collect all of my Tweaks into a Starter Template so I don’t have to pull up old themes to go looking for them.

-> app/themes/dwp/
-> dwp/functions.php 
####

Modified .htaccess

Localhost install in /wp/ directory. 
Sets deflate compression
Add security: Some may replicate server wide settings in /etc/apache2/custom.d/ or disable functionality 

Added /SRDB/ submodule – https://github.com/interconnectit/Search-Replace-DB/

---

DWP Theme:

https://code.davidawindham.com/david/dwp

Theme code @ code.davidawindham.com/dwp

• NPM for packages –> package.json
  • Gulp for automation preprocessing
  • Concat, PurgeCSS, Sass, Uglify, BrowserSync
• Front End Frameworks
  • Bootstrap
  • TailWindCSS
• /_src for moving files from node packages ( no production )
• /img for all graphic assets ( ignored by git )
• /css for all .scss and .css
  • admin.scss ( admin )
  • colors.scss ( colors )
  • custom.scss ( all styles )
  • style.css ( required by theme – blank on purpose )
  • style.min.css ( production colors + custom + style )
  • /fonts ( ignored by git – used for fonts and glyphs )
• /inc
  • theme.php ( all site specific dependent functions )
  • theme-templates.php ( all template functions )
  • wp-admin.php ( all admin functions)
  • wp-cleaner.php ( generic wp cleanup )
  • wp-nav-walker.php ( rewrite the wp navigation output )
  • wp-nav-walker-mega.php (rewrite the wp nav for mega menus )
• /js
  • admin.js ( admin js )
  • editor.js ( Gutenberg specific )
  • init.js ( site specific )
  • script.min.js ( front-end + additional libraries from packages )

DWP

code.davidawindham.com/dwp
github.com/windhamdavid/dwp

Just another WordPress starter theme. It’s a minimalist framework of templates I use inside of my wp repo @ code.davidawindham.com/david/wp alongside of the theme unit testing. I updated it recently to add custom blocks for widgets and style the editor blocks to match the front end.

---

ca·ve·at git·mptor: do not clone ( build your own, you’ll learn more )

---

Built With:

WordPress, Bootstrap, Node, NPM, Gulp, BrowserSync, Sass, PurgeCSS, and others.
( check the package.json file )

Usage

$ npm install
$ gulp copy / build / run

• edit gulpfile.js for BrowserSync proxy
• edit custom.scss file for theme
• gulp build to concatonate .js/.css files
• edit page-b to use the Theme Scheme template

Notes:

2021.2.17 – ( v. 0.0.2 )

• added page-theme-test.php template with all elements.
• trimmed the inc/ files down to wp-cleaner, wp-templates, wp-nav-walker
• trimmed the avaiable blocks and patterns in functions.php
• simplified the css to rely on the block-library
• moved all custom functions into theme.php
• added js/editor.js to accommodate blocks

---

DWP Plugin:

https://code.davidawindham.com/david/dwp-guten

Plugin code @ code.davidawindham.com/dwpp

• /app/plugins/dwpp
• used to build and customize Gutenberg
  • /src/index.js ( main control )
  • /build /index.js ( main + packages )

DWP Gutenberg

( WordPress Plugin )

build theme features into the gutenberg editor using a plugin.

https://davidawindham.com/gutenberg-sidebar/

v. 0.1 – Add Superscript and Subscript to Gutenberg so I can make citations in my posts.

v. 0.2 – Add ‘Meta Excerpt’ for postmeta:meta-desc alternative to post excerpt from the function ‘dw_ good_excerpt’

v. 0.3 – Add ‘Media’ URL postmeta for the OpenGraph/Twitter embedded media container

v. 0.4 – Rm Sub/Sup because they were added to core. Bring all packages up to date.

---