PHPackages                             cehojac/antonella-framework-for-wp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. cehojac/antonella-framework-for-wp

ActiveProject[Framework](/categories/framework)

cehojac/antonella-framework-for-wp
==================================

make easy a WordPress Plugin whit a team. Use this framework for simplycity the work in develop a plugin

1.9.2(3mo ago)207605[2 issues](https://github.com/cehojac/antonella-framework-for-wp/issues)[1 PRs](https://github.com/cehojac/antonella-framework-for-wp/pulls)MITPHPPHP >=8.0.0

Since Jun 4Pushed 3mo ago4 watchersCompare

[ Source](https://github.com/cehojac/antonella-framework-for-wp)[ Packagist](https://packagist.org/packages/cehojac/antonella-framework-for-wp)[ RSS](/packages/cehojac-antonella-framework-for-wp/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (6)DependenciesVersions (8)Used By (0)

🚀 Antonella Framework for WordPress
===================================

[](#-antonella-framework-for-wordpress)

[![Antonella Framework](https://camo.githubusercontent.com/53ec8ee407db122f60a32b2cefec4d172234c4124c7f4b6355ac8d19b91c6837/68747470733a2f2f6c65676163792e616e746f6e656c6c616672616d65776f726b2e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031382f30362f616e6f6e656c6c612d7265706f7369746f72696f2e706e67)](https://camo.githubusercontent.com/53ec8ee407db122f60a32b2cefec4d172234c4124c7f4b6355ac8d19b91c6837/68747470733a2f2f6c65676163792e616e746f6e656c6c616672616d65776f726b2e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031382f30362f616e6f6e656c6c612d7265706f7369746f72696f2e706e67)

[![DeepWiki](https://camo.githubusercontent.com/3b4bfe51545e3291aa942c3511a97cf85edb8c4dc94328722ef5edf9a428a6c1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4465657057696b692d416e746f6e656c6c615f4672616d65776f726b2d626c75653f6c6f676f3d77696b697065646961)](https://deepwiki.com/cehojac/antonella-framework-for-wp)

[![Total Downloads](https://camo.githubusercontent.com/8e604a9be7491942f68390d85c2b61442b2f9a6296ec345faaaf96078ac8576b/68747470733a2f2f706f7365722e707567782e6f72672f6365686f6a61632f616e746f6e656c6c612d6672616d65776f726b2d666f722d77702f646f776e6c6f616473)](https://packagist.org/packages/cehojac/antonella-framework-for-wp)[![Latest Version](https://camo.githubusercontent.com/b3d0ad7a1fcd4fb24812399a849bacd8300d82f1e82a49cdabd8f6f0d426b08b/68747470733a2f2f706f7365722e707567782e6f72672f6365686f6a61632f616e746f6e656c6c612d6672616d65776f726b2d666f722d77702f762f737461626c65)](https://packagist.org/packages/cehojac/antonella-framework-for-wp)[![License](https://camo.githubusercontent.com/711de5e26bad0d8e6078a2d1b77c5ac24131c772b01d33875cafa15b2443a7da/68747470733a2f2f706f7365722e707567782e6f72672f6365686f6a61632f616e746f6e656c6c612d6672616d65776f726b2d666f722d77702f6c6963656e7365)](https://packagist.org/packages/cehojac/antonella-framework-for-wp)[![Gitter](https://camo.githubusercontent.com/5a59bcdd9d2ef0823755c6372c46b242c5d616c35eae4dd4397265c19bd9c277/68747470733a2f2f6261646765732e6769747465722e696d2f416e746f6e656c6c612d4672616d65776f726b2f636f6d6d756e6974792e737667)](https://gitter.im/Antonella-Framework/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

**Framework for developing WordPress plugins based on Model View Controller with enterprise-level security**

📖 **Full Documentation**:
🎥 **Video Tutorial**:

---

✨ What's New in Version 1.9.0
-----------------------------

[](#-whats-new-in-version-190)

### 🔒 **Enterprise-Level Security**

[](#-enterprise-level-security)

- **CSRF Protection**: Automatic nonce verification
- **Permission Control**: Granular user capability checks
- **Input Sanitization**: Automatic data cleaning
- **Output Escaping**: XSS attack prevention
- **Security Class**: Centralized API for all security functions

### 🛠️ **Technical Improvements**

[](#️-technical-improvements)

- **PHP 8.2 Compatible**: Full compatibility with latest PHP
- **Enhanced Headers**: Complete plugin metadata
- **Docker Integration**: Improved development environment
- **Auto Root File Change**: Automatic plugin file renaming

---

📋 Requirements
--------------

[](#-requirements)

### **Core Requirements**

[](#core-requirements)

- **PHP**: 8.0 or higher
- **Composer**: Latest version
- **Git**: For version control
- **WordPress**: 5.0 or higher

### **Docker Development Environment**

[](#docker-development-environment)

- **Docker Desktop**: 4.53.0+ (⚠️ **Required for ARM64/Windows compatibility**)
- **Docker Compose**: v2.0+
- **Available Ports**: 8080 (WordPress), 3306 (MySQL), 9000 (phpMyAdmin)

> **💡 Note**: For optimal ARM64 compatibility on Windows/Mac, ensure Docker Desktop is updated to version 4.53.0 or higher. Earlier versions may experience container startup issues.

---

🚀 Quick Installation
--------------------

[](#-quick-installation)

### 1. Create Your Plugin Project

[](#1-create-your-plugin-project)

Via Antonella installer

```
composer global require cehojac/antonella-installer
antonella new my-awesome-plugin
cd my-awesome-plugin
```

or via composer CLI

```
composer create-project --prefer-dist cehojac/antonella-framework-for-wp my-awesome-plugin
cd my-awesome-plugin
```

### 2. Initialize Your Project

[](#2-initialize-your-project)

```
php antonella namespace MyPlugin
php antonella updateproject
```

### 3. Start Development

[](#3-start-development)

#### **Option A: Traditional WordPress Development**

[](#option-a-traditional-wordpress-development)

Your plugin is now ready! Upload to WordPress and start developing.

#### **Option B: Docker Development Environment**

[](#option-b-docker-development-environment)

For a complete development setup with database and admin interface:

```
# Start the development environment
php antonella serve
# or manually with Docker Compose
docker compose up -d

# Access your development site
# WordPress: http://localhost:8080
# Admin Panel: http://localhost:8080/wp-admin (test/test)
# phpMyAdmin: http://localhost:9000
```

**🐳 Docker Environment Includes:**

- WordPress with automatic framework activation
- MySQL 8.0 with persistent data
- phpMyAdmin for database management
- WP-CLI for command automation
- Development plugins (Query Monitor, Debug Bar)

**📋 Default Credentials:**

- **WordPress Admin**: `test` / `test`
- **MySQL**: `wordpress` / `wordpress`

> **🔧 Troubleshooting**: If containers fail to start, ensure Docker Desktop is updated to 4.53.0+ and required ports (8080, 3306, 9000) are available.

---

🎯 Core Features
---------------

[](#-core-features)

### **Console Commands**

[](#console-commands)

CommandDescription`php antonella namespace FOO`Rename namespace across all files`php antonella make MyController`Create controller class`php antonella widget MyWidget`Create widget class`php antonella helper myFunction`Create helper function`php antonella cpt MyPostType`Create custom post type`php antonella block MyBlock`Create Gutenberg block`php antonella makeup`Generate ZIP for distribution`php antonella serve`Start development server### **Security API**

[](#security-api)

```
use CH\Security;

// Verify user permissions
Security::check_user_capability('manage_options');

// Create secure forms
echo Security::create_nonce_field('my_action');
Security::verify_nonce('my_nonce', 'my_action');

// Sanitize input data
$data = Security::sanitize_input($_POST['data'], 'text');

// Escape output data
echo Security::escape_output($data);
```

### **Built-in Capabilities**

[](#built-in-capabilities)

- ✅ **MVC Architecture**: Clean separation of concerns
- ✅ **Security First**: Enterprise-level protection
- ✅ **Auto-loading**: PSR-4 compliant
- ✅ **Blade Templates**: Optional template engine
- ✅ **Custom Post Types**: Easy CPT creation
- ✅ **Gutenberg Blocks**: Block development tools
- ✅ **Docker Support**: Containerized development
- ✅ **Testing Framework**: Built-in testing tools

---

🛡️ Security Features
--------------------

[](#️-security-features)

### **CSRF Protection**

[](#csrf-protection)

```
// In your form
echo Security::create_nonce_field('update_settings');

// In your controller
Security::verify_nonce('settings_nonce', 'update_settings');
```

### **Data Sanitization**

[](#data-sanitization)

```
$text = Security::sanitize_input($_POST['text'], 'text');
$email = Security::sanitize_input($_POST['email'], 'email');
$url = Security::sanitize_input($_POST['url'], 'url');
$html = Security::sanitize_input($_POST['content'], 'html');
```

### **Output Escaping**

[](#output-escaping)

```
echo Security::escape_output($user_data, 'html');
echo '';
echo 'var data = ' . Security::escape_output($js_data, 'js') . ';';
```

---

🐳 Development with Docker
-------------------------

[](#-development-with-docker)

### Start Development Environment

[](#start-development-environment)

```
php antonella serve
# or
php antonella serve -d  # detached mode
```

### Features Include:

[](#features-include)

- WordPress latest version
- PHP 8.2
- MySQL 8.0
- Automatic plugin installation
- Hot reloading

---

📦 Plugin Distribution
---------------------

[](#-plugin-distribution)

### Create Production ZIP

[](#create-production-zip)

```
php antonella makeup
```

This command:

- ✅ Excludes development files
- ✅ Includes only production dependencies
- ✅ Creates optimized ZIP file
- ✅ Maintains proper file structure

---

🔧 Migration from 1.8.x
----------------------

[](#-migration-from-18x)

### Update Your Controllers

[](#update-your-controllers)

**Before (1.8.x):**

```
public function process_form() {
    $data = $_POST['data'];
    update_option('my_option', $data);
}
```

**After (1.9.0):**

```
public function process_form() {
    Security::check_user_capability('manage_options');
    Security::verify_nonce('my_nonce', 'my_action');

    $data = Security::sanitize_input($_POST['data'], 'text');
    update_option('my_option', $data);
}
```

---

🤝 Contributing
--------------

[](#-contributing)

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

---

📞 Support
---------

[](#-support)

- **Documentation**: [antonellaframework.com/documentacion](https://antonellaframework.com/documentacion)
- **Community Chat**: [Gitter](https://gitter.im/Antonella-Framework/community)
- **Issues**: [GitHub Issues](https://github.com/cehojac/antonella-framework-for-wp/issues)
- **Email**:

---

📄 License
---------

[](#-license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

🎉 Made with ❤️ by Carlos Herrera
--------------------------------

[](#-made-with-️-by-carlos-herrera)

**Antonella Framework** - Making WordPress plugin development secure, fast, and enjoyable!

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance77

Regular maintenance activity

Popularity25

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 84.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~558 days

Recently: every ~249 days

Total

6

Last Release

111d ago

Major Versions

1.9.0 → 2.0.x-dev2025-08-31

### Community

Maintainers

![](https://www.gravatar.com/avatar/f47eb02703b705a42d3f4a51233a2038edc1deb9115b563628a35fac40d72150?d=identicon)[cehojac](/maintainers/cehojac)

---

Top Contributors

[![cehojac](https://avatars.githubusercontent.com/u/1319696?v=4)](https://github.com/cehojac "cehojac (77 commits)")[![bmiguelbc16](https://avatars.githubusercontent.com/u/157254261?v=4)](https://github.com/bmiguelbc16 "bmiguelbc16 (14 commits)")

---

Tags

antonella-frameworkframeworkmvcphpphp8pluginpoowordpresswordpress-developmentwordpress-pluginsframeworkwordpressplugins

### Embed Badge

![Health badge](/badges/cehojac-antonella-framework-for-wp/health.svg)

```
[![Health](https://phpackages.com/badges/cehojac-antonella-framework-for-wp/health.svg)](https://phpackages.com/packages/cehojac-antonella-framework-for-wp)
```

###  Alternatives

[wpbones/wpbones

WordPress framework for Laravel developers

1714.8k1](/packages/wpbones-wpbones)[themosis/theme

The Themosis framework boilerplate theme.

10449.0k3](/packages/themosis-theme)[wpstarter/framework

The WpStarter Framework - Laravel Framework for WordPress

1810.1k4](/packages/wpstarter-framework)[alleyinteractive/pest-plugin-wordpress

WordPress Pest Integration

263.7k1](/packages/alleyinteractive-pest-plugin-wordpress)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)