@mytechtoday/augment-extensions 0.1.2 → 0.4.0

package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php

@@ -0,0 +1,189 @@
+<?php
+/**
+ * Plugin Name: Custom Content Manager
+ * Plugin URI: https://example.com/custom-content-manager
+ * Description: A custom WordPress plugin demonstrating best practices for plugin development
+ * Version: 1.0.0
+ * Author: Your Name
+ * Author URI: https://example.com
+ * License: GPL v2 or later
+ * License URI: https://www.gnu.org/licenses/gpl-2.0.html
+ * Text Domain: custom-content-manager
+ * Domain Path: /languages
+ * Requires at least: 5.8
+ * Requires PHP: 7.4
+ */
+
+// Prevent direct access
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+// Define plugin constants
+define('CCM_VERSION', '1.0.0');
+define('CCM_PLUGIN_DIR', plugin_dir_path(__FILE__));
+define('CCM_PLUGIN_URL', plugin_dir_url(__FILE__));
+define('CCM_PLUGIN_BASENAME', plugin_basename(__FILE__));
+
+/**
+ * Main Plugin Class
+ */
+class Custom_Content_Manager
+{
+    private static $instance = null;
+    
+    /**
+     * Singleton instance
+     */
+    public static function get_instance()
+    {
+        if (null === self::$instance) {
+            self::$instance = new self();
+        }
+        return self::$instance;
+    }
+    
+    /**
+     * Constructor
+     */
+    private function __construct()
+    {
+        $this->load_dependencies();
+        $this->init_hooks();
+    }
+    
+    /**
+     * Load required files
+     */
+    private function load_dependencies()
+    {
+        require_once CCM_PLUGIN_DIR . 'includes/class-ccm-post-type.php';
+        require_once CCM_PLUGIN_DIR . 'includes/class-ccm-meta-box.php';
+        require_once CCM_PLUGIN_DIR . 'includes/class-ccm-shortcode.php';
+    }
+    
+    /**
+     * Initialize WordPress hooks
+     */
+    private function init_hooks()
+    {
+        // Activation/Deactivation
+        register_activation_hook(__FILE__, [$this, 'activate']);
+        register_deactivation_hook(__FILE__, [$this, 'deactivate']);
+        
+        // Core hooks
+        add_action('init', [$this, 'init']);
+        add_action('admin_init', [$this, 'admin_init']);
+        add_action('admin_menu', [$this, 'add_admin_menu']);
+        add_action('admin_enqueue_scripts', [$this, 'enqueue_admin_assets']);
+        add_action('wp_enqueue_scripts', [$this, 'enqueue_frontend_assets']);
+        
+        // AJAX hooks
+        add_action('wp_ajax_ccm_save_settings', [$this, 'ajax_save_settings']);
+        add_action('wp_ajax_ccm_get_content', [$this, 'ajax_get_content']);
+    }
+    
+    /**
+     * Plugin activation
+     */
+    public function activate()
+    {
+        // Create custom database table if needed
+        global $wpdb;
+        $table_name = $wpdb->prefix . 'ccm_content';
+        
+        $charset_collate = $wpdb->get_charset_collate();
+        
+        $sql = "CREATE TABLE IF NOT EXISTS $table_name (
+            id bigint(20) NOT NULL AUTO_INCREMENT,
+            post_id bigint(20) NOT NULL,
+            content_type varchar(50) NOT NULL,
+            content_data longtext NOT NULL,
+            created_at datetime DEFAULT CURRENT_TIMESTAMP,
+            updated_at datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+            PRIMARY KEY  (id),
+            KEY post_id (post_id)
+        ) $charset_collate;";
+        
+        require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
+        dbDelta($sql);
+        
+        // Set default options
+        add_option('ccm_version', CCM_VERSION);
+        add_option('ccm_settings', [
+            'enable_feature_x' => true,
+            'items_per_page' => 10
+        ]);
+        
+        // Flush rewrite rules
+        flush_rewrite_rules();
+    }
+    
+    /**
+     * Plugin deactivation
+     */
+    public function deactivate()
+    {
+        flush_rewrite_rules();
+    }
+    
+    /**
+     * Initialize plugin
+     */
+    public function init()
+    {
+        // Load text domain for translations
+        load_plugin_textdomain(
+            'custom-content-manager',
+            false,
+            dirname(CCM_PLUGIN_BASENAME) . '/languages'
+        );
+        
+        // Register custom post type
+        CCM_Post_Type::register();
+        
+        // Register shortcodes
+        CCM_Shortcode::register();
+    }
+    
+    /**
+     * Admin initialization
+     */
+    public function admin_init()
+    {
+        // Register settings
+        register_setting('ccm_settings_group', 'ccm_settings', [
+            'sanitize_callback' => [$this, 'sanitize_settings']
+        ]);
+        
+        // Add meta boxes
+        add_action('add_meta_boxes', [CCM_Meta_Box::class, 'add']);
+        add_action('save_post', [CCM_Meta_Box::class, 'save']);
+    }
+    
+    /**
+     * Add admin menu
+     */
+    public function add_admin_menu()
+    {
+        add_menu_page(
+            __('Content Manager', 'custom-content-manager'),
+            __('Content Manager', 'custom-content-manager'),
+            'manage_options',
+            'custom-content-manager',
+            [$this, 'render_admin_page'],
+            'dashicons-admin-generic',
+            20
+        );
+        
+        add_submenu_page(
+            'custom-content-manager',
+            __('Settings', 'custom-content-manager'),
+            __('Settings', 'custom-content-manager'),
+            'manage_options',
+            'ccm-settings',
+            [$this, 'render_settings_page']
+        );
+    }
+}
+

package/augment-extensions/coding-standards/php/module.json

@@ -0,0 +1,166 @@
+{
+  "name": "php-standards",
+  "version": "1.0.0",
+  "displayName": "PHP Coding Standards",
+  "description": "Comprehensive PHP coding standards following PSR standards and modern PHP best practices across various project types including web applications, APIs, CLI tools, CMS integrations, e-commerce systems, and legacy migrations.",
+  "type": "coding-standards",
+  "author": "Augment Extensions",
+  "license": "MIT",
+  "keywords": [
+    "php",
+    "coding-standards",
+    "psr",
+    "psr-1",
+    "psr-12",
+    "psr-4",
+    "psr-7",
+    "web",
+    "api",
+    "cli",
+    "cms",
+    "wordpress",
+    "ecommerce",
+    "woocommerce",
+    "legacy",
+    "security",
+    "performance",
+    "testing"
+  ],
+  "augment": {
+    "characterCount": 186539,
+    "priority": "high",
+    "category": "coding-standards",
+    "appliesTo": {
+      "languages": ["php"],
+      "filePatterns": ["**/*.php"],
+      "frameworks": [
+        "laravel",
+        "symfony",
+        "wordpress",
+        "drupal",
+        "woocommerce",
+        "magento"
+      ]
+    },
+    "categories": {
+      "web": {
+        "description": "Web applications with MVC architecture",
+        "rules": ["web-applications.md"],
+        "examples": ["web-application-example.php"]
+      },
+      "api": {
+        "description": "RESTful API development",
+        "rules": ["api-development.md"],
+        "examples": ["api-endpoint-example.php"]
+      },
+      "cli": {
+        "description": "Command-line tools and scripts",
+        "rules": ["cli-tools.md"],
+        "examples": ["cli-command-example.php"]
+      },
+      "cms": {
+        "description": "CMS integrations (WordPress, Drupal)",
+        "rules": ["cms-integration.md"],
+        "examples": ["wordpress-plugin-example.php"]
+      },
+      "ecommerce": {
+        "description": "E-commerce systems and integrations",
+        "rules": ["ecommerce.md"],
+        "examples": ["woocommerce-extension-example.php"]
+      },
+      "legacy": {
+        "description": "Legacy code migration and refactoring",
+        "rules": ["legacy-migration.md"],
+        "examples": ["legacy-refactoring-example.php"]
+      }
+    },
+    "universalRules": [
+      "psr-standards.md",
+      "naming-conventions.md",
+      "type-declarations.md",
+      "error-handling.md",
+      "security.md",
+      "performance.md",
+      "testing.md",
+      "documentation.md",
+      "code-quality.md",
+      "category-configuration.md"
+    ]
+  },
+  "installation": {
+    "required": false,
+    "instructions": "This module is automatically loaded when working with PHP files. Configure categories in .augment/php-config.json"
+  },
+  "configuration": {
+    "file": ".augment/php-config.json",
+    "schema": {
+      "php_categories": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": ["web", "api", "cli", "cms", "ecommerce", "legacy"]
+        },
+        "description": "Project categories to apply"
+      },
+      "psr_standards": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": ["PSR-1", "PSR-12", "PSR-4", "PSR-7", "PSR-11", "PSR-15", "PSR-18"]
+        },
+        "description": "PSR standards to enforce"
+      },
+      "php_version": {
+        "type": "string",
+        "description": "Minimum PHP version",
+        "default": "8.0"
+      },
+      "strict_types": {
+        "type": "boolean",
+        "description": "Enforce strict type declarations",
+        "default": true
+      },
+      "static_analysis": {
+        "type": "object",
+        "properties": {
+          "tool": {
+            "type": "string",
+            "enum": ["phpstan", "psalm"]
+          },
+          "level": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 8
+          }
+        }
+      },
+      "code_style": {
+        "type": "object",
+        "properties": {
+          "tool": {
+            "type": "string",
+            "enum": ["php-cs-fixer", "phpcs"]
+          },
+          "ruleset": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "composer": {
+      "phpunit/phpunit": "^10.0",
+      "phpstan/phpstan": "^1.10",
+      "friendsofphp/php-cs-fixer": "^3.0"
+    }
+  },
+  "links": {
+    "homepage": "https://github.com/augment-code/augment-extensions",
+    "documentation": "https://github.com/augment-code/augment-extensions/tree/main/augment-extensions/coding-standards/php",
+    "psr": "https://www.php-fig.org/psr/",
+    "phpstan": "https://phpstan.org/",
+    "php-cs-fixer": "https://cs.symfony.com/"
+  }
+}
+