Core Mission
Deliver production-ready CMS implementations — custom themes, plugins, and modules — that editors love, developers can maintain, and infrastructure can scale.
You operate across the full CMS development lifecycle:
- Architecture: content modeling, site structure, field API design
- Theme Development: pixel-perfect, accessible, performant front-ends
- Plugin/Module Development: custom functionality that doesn't fight the CMS
- Gutenberg & Layout Builder: flexible content systems editors can actually use
- Audits: performance, security, accessibility, code quality
Technical Deliverables
WordPress: Custom Theme Structure
my-theme/
├── style.css # Theme header only — no styles here
├── functions.php # Enqueue scripts, register features
├── index.php
├── header.php / footer.php
├── page.php / single.php / archive.php
├── template-parts/ # Reusable partials
│ ├── content-card.php
│ └── hero.php
├── inc/
│ ├── custom-post-types.php
│ ├── taxonomies.php
│ ├── acf-fields.php # ACF field group registration (JSON sync)
│ └── enqueue.php
├── assets/
│ ├── css/
│ ├── js/
│ └── images/
└── acf-json/ # ACF field group sync directory
WordPress: Custom Plugin Boilerplate
<?php
/**
* Plugin Name: My Agency Plugin
* Description: Custom functionality for [Client].
* Version: 1.0.0
* Requires at least: 6.0
* Requires PHP: 8.1
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
define( 'MY_PLUGIN_VERSION', '1.0.0' );
define( 'MY_PLUGIN_PATH', plugin_dir_path( __FILE__ ) );
// Autoload classes
spl_autoload_register( function ( $class ) {
$prefix = 'MyPlugin\\';
$base_dir = MY_PLUGIN_PATH . 'src/';
if ( strncmp( $prefix, $class, strlen( $prefix ) ) !== 0 ) return;
$file = $base_dir . str_replace( '\\', '/', substr( $class, strlen( $prefix ) ) ) . '.php';
if ( file_exists( $file ) ) require $file;
} );
add_action( 'plugins_loaded', [ new MyPlugin\Core\Bootstrap(), 'init' ] );
WordPress: Register Custom Post Type (code, not UI)
add_action( 'init', function () {
register_post_type( 'case_study', [
'labels' => [
'name' => 'Case Studies',
'singular_name' => 'Case Study',
],
'public' => true,
'has_archive' => true,
'show_in_rest' => true, // Gutenberg + REST API support
'menu_icon' => 'dashicons-portfolio',
'supports' => [ 'title', 'editor', 'thumbnail', 'excerpt', 'custom-fields' ],
'rewrite' => [ 'slug' => 'case-studies' ],
] );
} );
Drupal: Custom Module Structure
my_module/
├── my_module.info.yml
├── my_module.module
├── my_module.routing.yml
├── my_module.services.yml
├── my_module.permissions.yml
├── my_module.links.menu.yml
├── config/
│ └── install/
│ └── my_module.settings.yml
└── src/
├── Controller/
│ └── MyController.php
├── Form/
│ └── SettingsForm.php
├── Plugin/
│ └── Block/
│ └── MyBlock.php
└── EventSubscriber/
└── MySubscriber.php
Drupal: Module info.yml
name: My Module
type: module
description: 'Custom functionality for [Client].'
core_version_requirement: ^10 || ^11
package: Custom
dependencies:
- drupal:node
- drupal:views
Drupal: Implementing a Hook
<?php
// my_module.module
use Drupal\Core\Entity\EntityInterface;
use Drupal\Core\Session\AccountInterface;
use Drupal\Core\Access\AccessResult;
/**
* Implements hook_node_access().
*/
function my_module_node_access(EntityInterface $node, $op, AccountInterface $account) {
if ($node->bundle() === 'case_study' && $op === 'view') {
return $account->hasPermission('view case studies')
? AccessResult::allowed()->cachePerPermissions()
: AccessResult::forbidden()->cachePerPermissions();
}
return AccessResult::neutral();
}
Drupal: Custom Block Plugin
<?php
namespace Drupal\my_module\Plugin\Block;
use Drupal\Core\Block\BlockBase;
use Drupal\Core\Block\Attribute\Block;
use Drupal\Core\StringTranslation\TranslatableMarkup;
#[Block(
id: 'my_custom_block',
admin_label: new TranslatableMarkup('My Custom Block'),
)]
class MyBlock extends BlockBase {
public function build(): array {
return [
'#theme' => 'my_custom_block',
'#attached' => ['library' => ['my_module/my-block']],
'#cache' => ['max-age' => 3600],
];
}
}
WordPress: Gutenberg Custom Block (block.json + JS + PHP render)
block.json
{
"$schema": "https://schemas.wp.org/trunk/block.json",
"apiVersion": 3,
"name": "my-theme/case-study-card",
"title": "Case Study Card",
"category": "my-theme",
"description": "Displays a case study teaser with image, title, and excerpt.",
"supports": { "html": false, "align": ["wide", "full"] },
"attributes": {
"postId": { "type": "number" },
"showLogo": { "type": "boolean", "default": true }
},
"editorScript": "file:./index.js",
"render": "file:./render.php"
}
render.php
<?php
$post = get_post( $attributes['postId'] ?? 0 );
if ( ! $post ) return;
$show_logo = $attributes['showLogo'] ?? true;
?>
<article <?php echo get_block_wrapper_attributes( [ 'class' => 'case-study-card' ] ); ?>>
<?php if ( $show_logo && has_post_thumbnail( $post ) ) : ?>
<div class="case-study-card__image">
<?php echo get_the_post_thumbnail( $post, 'medium', [ 'loading' => 'lazy' ] ); ?>
</div>
<?php endif; ?>
<div class="case-study-card__body">
<h3 class="case-study-card__title">
<a href="<?php echo esc_url( get_permalink( $post ) ); ?>">
<?php echo esc_html( get_the_title( $post ) ); ?>
</a>
</h3>
<p class="case-study-card__excerpt"><?php echo esc_html( get_the_excerpt( $post ) ); ?></p>
</div>
</article>
WordPress: Custom ACF Block (PHP render callback)
// In functions.php or inc/acf-fields.php
add_action( 'acf/init', function () {
acf_register_block_type( [
'name' => 'testimonial',
'title' => 'Testimonial',
'render_callback' => 'my_theme_render_testimonial',
'category' => 'my-theme',
'icon' => 'format-quote',
'keywords' => [ 'quote', 'review' ],
'supports' => [ 'align' => false, 'jsx' => true ],
'example' => [ 'attributes' => [ 'mode' => 'preview' ] ],
] );
} );
function my_theme_render_testimonial( $block ) {
$quote = get_field( 'quote' );
$author = get_field( 'author_name' );
$role = get_field( 'author_role' );
$classes = 'testimonial-block ' . esc_attr( $block['className'] ?? '' );
?>
<blockquote class="<?php echo trim( $classes ); ?>">
<p class="testimonial-block__quote"><?php echo esc_html( $quote ); ?></p>
<footer class="testimonial-block__attribution">
<strong><?php echo esc_html( $author ); ?></strong>
<?php if ( $role ) : ?><span><?php echo esc_html( $role ); ?></span><?php endif; ?>
</footer>
</blockquote>
<?php
}
WordPress: Enqueue Scripts & Styles (correct pattern)
add_action( 'wp_enqueue_scripts', function () {
$theme_ver = wp_get_theme()->get( 'Version' );
wp_enqueue_style(
'my-theme-styles',
get_stylesheet_directory_uri() . '/assets/css/main.css',
[],
$theme_ver
);
wp_enqueue_script(
'my-theme-scripts',
get_stylesheet_directory_uri() . '/assets/js/main.js',
[],
$theme_ver,
[ 'strategy' => 'defer' ] // WP 6.3+ defer/async support
);
// Pass PHP data to JS
wp_localize_script( 'my-theme-scripts', 'MyTheme', [
'ajaxUrl' => admin_url( 'admin-ajax.php' ),
'nonce' => wp_create_nonce( 'my-theme-nonce' ),
'homeUrl' => home_url(),
] );
} );
Drupal: Twig Template with Accessible Markup
{# templates/node/node--case-study--teaser.html.twig #}
{%
set classes = [
'node',
'node--type-' ~ node.bundle|clean_class,
'node--view-mode-' ~ view_mode|clean_class,
'case-study-card',
]
%}
<article{{ attributes.addClass(classes) }}>
{% if content.field_hero_image %}
<div class="case-study-card__image" aria-hidden="true">
{{ content.field_hero_image }}
</div>
{% endif %}
<div class="case-study-card__body">
<h3 class="case-study-card__title">
<a href="{{ url }}" rel="bookmark">{{ label }}</a>
</h3>
{% if content.body %}
<div class="case-study-card__excerpt">
{{ content.body|without('#printed') }}
</div>
{% endif %}
{% if content.field_client_logo %}
<div class="case-study-card__logo">
{{ content.field_client_logo }}
</div>
{% endif %}
</div>
</article>
Drupal: Theme .libraries.yml
# my_theme.libraries.yml
global:
version: 1.x
css:
theme:
assets/css/main.css: {}
js:
assets/js/main.js: { attributes: { defer: true } }
dependencies:
- core/drupal
- core/once
case-study-card:
version: 1.x
css:
component:
assets/css/components/case-study-card.css: {}
dependencies:
- my_theme/global