القائمة
File naming conventions and namespace-to-directory mapping for PHP files. Use when creating new classes, traits, interfaces, or abstract classes to ensure proper autoloading.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Handle plugin activation, deactivation, and uninstall. Use when setting up database tables, default options, cleanup tasks, or requirement checks.
Use Hooker service to register WordPress actions and filters. Use when adding WordPress hooks, filters, or actions in the plugin. Never use add_action or add_filter directly.
Create service providers to register and boot services in the WordPress plugin. Use when adding new features, controllers, or services that need dependency injection and initialization.
Use existing traits and create custom traits for code reuse. Use when sharing common functionality across multiple classes without inheritance.
Modify webpack configuration in src/config/ - add entry points, loaders, plugins, aliases. Use when user needs to customize webpack build, add React/TypeScript, modify Babel, add PostCSS plugins, or change dev server settings.
Create AJAX handlers for WordPress admin and frontend. Use when handling asynchronous requests from JavaScript, form submissions, or dynamic content loading.
| name | file-naming |
| description | File naming conventions and namespace-to-directory mapping for PHP files. Use when creating new classes, traits, interfaces, or abstract classes to ensure proper autoloading. |
Strict naming conventions for autoloader compatibility.
Pattern: class-{kebab-case-name}.php
SettingsPage → class-settings-page.php
PostController → class-post-controller.php
EmailService → class-email-service.php
AjaxHandler → class-ajax-handler.php
Pattern: trait-{kebab-case-name}.php
LoggingTrait → trait-logging.php
LoggingTrait → trait-logging.php
CachingTrait → trait-caching.php
LoggingTrait → trait-logging.php
Pattern: interface-{kebab-case-name}.php
ServiceProviderInterface → interface-service-provider.php
RepositoryInterface → interface-repository.php
CacheInterface → interface-cache.php
Pattern: class-abstract-{kebab-case-name}.php
AbstractServiceProvider → class-abstract-service-provider.php
AbstractRepository → class-abstract-repository.php
AbstractController → class-abstract-controller.php
WPPB → includes/
WPPB\Core → includes/core/
WPPB\Admin → includes/admin/
WPPB\Frontend → includes/frontend/
WPPB\Api → includes/api/
WPPB\Ajax → includes/ajax/
WPPB\Services → includes/services/
WPPB\Providers → includes/providers/
WPPB\PostTypes → includes/post-types/
WPPB\Taxonomies → includes/taxonomies/
WPPB\Traits → includes/traits/
WPPB\Interfaces → includes/interfaces/
WPPB\Abstracts → includes/abstracts/
<?php
/**
* Settings Page
*
* @package WPPB
*/
namespace WPPB\Admin;
defined( 'ABSPATH' ) || exit;
class SettingsPage {
// Class code
}
File: includes/admin/class-settings-page.php
<?php
/**
* Caching trait
*
* @package WPPB
*/
namespace WPPB\Traits;
defined( 'ABSPATH' ) || exit;
trait CachingTrait {
// Trait code
}
File: includes/traits/trait-caching.php
<?php
/**
* Repository interface
*
* @package WPPB
*/
namespace WPPB\Interfaces;
defined( 'ABSPATH' ) || exit;
interface RepositoryInterface {
// Interface code
}
File: includes/interfaces/interface-repository.php
<?php
/**
* Abstract repository
*
* @package WPPB
*/
namespace WPPB\Abstracts;
defined( 'ABSPATH' ) || exit;
abstract class AbstractRepository {
// Abstract class code
}
File: includes/abstracts/class-abstract-repository.php
SettingsPage → settings-page
PostController → post-controller
EmailService → email-service
AjaxHandler → ajax-handler
FormValidator → form-validator
CustomPostType → class-custom-post-type.php
RestApiController → class-rest-api-controller.php
AdminSettingsPage → class-admin-settings-page.php
FrontendAssetManager → class-frontend-asset-manager.php
When creating new namespace:
# Create directory
mkdir -p includes/services
# Create class
touch includes/services/class-email-service.php
Namespace must match:
namespace WPPB\Services;
class EmailService {
// Code
}
class_settings_page.php # Underscores
ClassSettingsPage.php # PascalCase filename
settings-page.php # Missing prefix
class-SettingsPage.php # Mixed case
class-settings-page.php
For autoloader to work:
Example:
Namespace: WPPB\Admin\SettingsPage
Directory: includes/admin/
Filename: class-settings-page.php
class-trait-interface-class-abstract-defined( 'ABSPATH' ) || exit;