joemaller

<?php

namespace IdeasOnPurpose;

/**
 * This class created a nice little persistent endpoint for an
 * externally referenced stylesheet. This was necessary because
 * our themes are versioned with each release living in a different-
 * named directory. All assets are also generated by Webpack and
 * have hashed filenames.

joemaller

#! /usr/bin/env bash

# Stop on errors, unset vars and broken pipes
set -o errexit
set -o nounset
set -o pipefail

LOG_FILE=${1:-}
if [ -z "$LOG_FILE" ]; then
  echo "Please provide a logfile as the first argument"

joemaller

docker run -it -v $PWD:/app alpine sh -c 'apk --no-cache add inotify-tools; inotifywait -m --format "%e %f" /app'

joemaller

#! /usr/bin/env bash

# This is a small collection of helper commands for migrating a legacy macOS fileserver
# to OneDrive/Sharepoint. Filenames on cloud platforms are more restrictive than macOS, so
# a large number of files needed renaming before they could be synced to the Microsoft Cloud.

# 1. Use the rename CLI tool. It's installed by default on Debian/Ubuntu but needs to be
#    installed on macOS and some other platforms. More here: http://plasmasturm.org/code/rename/

brew install rename

joemaller

Get PHP child Class file paths from inherited parent class methods

While refactoring some code into a reusable PHP Class I hit a brief roadblock where some code expected the [__FILE__ magic constant][file] file path. Since that value always refers to the specific file it's called from, it won't work from a separate Class file because the referenced path would be the parent instead of the child.

The full filepath of a child Class can be inferred from an inherited parent Class method by combining [get_class($this)][get_class] or [get_called_class()][get_called_class] with the [ReflectionClass::getFileName][getfilename] method like this:

// ParentClass.php
class ParentClass
{

joemaller

Postmortem on a multi-layered bug

Also, a very long, mostly miserable day.

The problem

A web project was recently updated but now won't build on some computers. The updates largely involved migrating the project to our [webpack-based Docker toolset][docker-build] which is in use on other projects and is supposed to be stable. Updates were authored on Macs, then tested on Windows -- where the whole project failed to run.

"THIS IS IMPOSSIBLE"

joemaller

Wrapped template fragments

When developing websites, the dev team at Ideas On Purpose has found it very useful to wrap template fragments in named HTML comments. During development and debugging, these waypoints reveal the exact files and structure of how how the page was assembled.

Most files look something like this:

<?php
  // a bunch of logic which populates the $pages variable
?>

joemaller

Even though individual Tags, Categories and Taxonomies are all represented as WP_Term objects, WordPress has three separate conditional tags for sorting them out: is_tag(), is_category() and is_tax(). These are sometimes combined into a single conditional statement in WordPress core, and there are plenty of examples on GitHub where developers have created an umbrella is_term() function like this:

function is_term($term = '') {
    return is_tag($term) || is_category($term) || is_tax($term);
}

It would be nice to have that function added to WordPress core.

joemaller

# Removes downloads older than 14 days. Runs every 6 hours
45	*/6	* 	* 	* 	find ~/Downloads -maxdepth 1 -mtime +14 -exec rm -rf {} \;

joemaller

Fixing post counts for WordPress taxonomies

The problem

For WordPress sites using Custom Post Types, Taxonomy admin listings show cumulative term-assignment totals for all post_types instead of counts specific to the selected post_type. Since Taxonomy listings are always attached to a single post_type, totals for shared taxonomies don't make sense.

The Goal

Fix term counts so wp-admin Taxonomy listings show the correct number of items for the selected post_type.