Howdy Structure Helper

Instructions

When creating new PHP classes or files:

1. Place in correct directory:

- Classes: app/Namespace/Class.php - Includes: inc/ directory

1. Apply namespace:

- Base: Retrologin\ - Example: Retrologin\Admin\Settings

1. Add required file header:

- declare(strict_types=1); - Docblock with description and @since

1. Include ABSPATH check at the top

File Structure Pattern

retrologin.php          # Main plugin file (header only)
app/
  Admin/
    Settings.php        # Class: Retrologin\Admin\Settings
  Frontend/
    Login.php           # Class: Retrologin\Frontend\Login
inc/
  bootstrap/
    app.php             # Bootstrap file

Class Template

<?php

declare(strict_types=1);

/**
 * Short description of the class.
 *
 * Longer description if needed.
 *
 * @package Retrologin
 * @since   0.1.0
 */

namespace Retrologin\Admin;

if (! defined('ABSPATH')) {
    exit;
}

/**
 * Class description.
 *
 * @since 0.1.0
 */
class Settings {

    /**
     * Constructor.
     *
     * @since 0.1.0
     */
    public function __construct() {
        // Hooks, filters, etc.
    }

    /**
     * Method description.
     *
     * @param string $param Description.
     * @return void
     * @since 0.1.0
     */
    public function method( string $param ): void {
        // ...
    }
}

Key Conventions

• Autoloading: Composer's PSR-4 maps Retrologin\ to app/
• Don't manually require files - use autoloading
• Coding standard: Syntatis (configured in phpcs.xml.dist)
• Linter: composer run lint
• Auto-fix: composer run format