mralaminahamed/forminator-stubs

Forminator function and class declaration stubs for static analysis.

v1.54.0 2026-06-15 07:47 UTC

Requires

• php: >=7.4
• php-stubs/wordpress-stubs: ^5.3 || ^6.0

Requires (Dev)

• php-stubs/generator: ^0.8.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^7.5 || ^8.5 || ^9.5
• squizlabs/php_codesniffer: ^3.7

Suggests

• symfony/polyfill-php73: Symfony polyfill backporting some PHP 7.3+ features to lower PHP versions
• szepeviktor/phpstan-wordpress: WordPress extensions for PHPStan

MIT

• Al Amin Ahamed

• wordpress
• static analysis
• stubs
• wordpress-plugin
• contact-form
• PHPStan
• forminator

README

PHP stub declarations for the Forminator plugin to enhance IDE completion and static analysis capabilities. Generated using php-stubs/generator directly from the source code.

🚀 Features

• Complete function, class, and interface declarations
• Constant definitions for proper static analysis
• IDE autocompletion support
• PHPStan integration
• Regular updates with latest Forminator plugin versions

📋 Requirements

• PHP >= 7.4
• Composer for dependency management

📦 Installation

Via Composer (Recommended)

# Install as a development dependency
composer require --dev mralaminahamed/forminator-stubs

# Or specify a version
composer require --dev mralaminahamed/forminator-stubs:^2.0

Manual Installation

Download the stub files directly:

• forminator-stubs.stub
• forminator-constants-stubs.stub

🔧 Basic Configuration

To use these stubs with PHPStan or your IDE, see our Usage Guide for detailed instructions.

🔍 Quick Usage Example

<?php
// Your code will now have full IDE support
$forms = Forminator_API::get_forms();

// Create a new form entry
$entry = Forminator_API::get_entry($entryId, $formId);

// Constants are properly defined
if (FORMINATOR_VERSION) {
    // Your implementation
}

For advanced usage examples, see the Usage Guide.

📁 Package Structure

phpstan-forminator-stubs/
├── configs/                               # Configuration files for stub generation
├── forminator-constants-stubs.stub        # Constants stub file
├── forminator-stubs.stub                  # Main stubs file with classes and functions
├── forminator_versions.txt                # Tracks supported Forminator versions
├── phpstan.neon                           # PHPStan configuration
├── source/                                # Source for generating stubs
├── tools/                                 # Helper tools for stub generation
└── tests/                                 # Test files
    ├── bootstrap.php                      # Test bootstrap
    ├── ConstantsTest.php                  # Constants tests
    └── ForminatorTest.php                 # Forminator tests

🛠 Development

For information on building stubs, running tests, and contributing to the project, please see our Contributing Guide.

📚 Documentation

For more detailed information, check out our documentation:

• Usage Guide
• Contributing Guide
• Forminator Documentation
• PHPStan Documentation
• PHP Stubs Generator Documentation

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• WPMU DEV for the Forminator plugin
• php-stubs/generator for the stub generation tools
• All contributors to this project

💬 Support

For bug reports and feature requests, please use the GitHub Issues.

For questions and discussions, please use the GitHub Discussions.