This is my first admin page!
```PHP
setRootMenuPage( 'My Settings' ); // create a root page
$this->addSubMenuItem(
array(
'title' => 'My First Form',
'page_slug' => 'my_first_form'
)
);
}
/**
* The pre-defined callback method that is triggered when the page loads.
* @callback action load_{page slug}
*/
public function load_my_first_form( $oAdminPage ) {
$this->addSettingSections(
array(
'section_id' => 'my_first_text_section',
'page_slug' => 'my_first_form',
)
);
$this->addSettingFields(
array(
'field_id' => 'text',
'section_id' => 'my_first_text_section',
'title' => 'Text',
'type' => 'text',
'default' => 123456,
),
array(
'field_id' => 'submit',
'type' => 'submit',
)
);
}
}
new APF_MyFirstFrom;
```
See more code examples in `Dashboard` -> `AdminPageFramework` -> `Help` -> `Examples`.
## Resources
- [Online documentation](http://admin-page-framework.michaeluno.jp/en/v3/)
- [Online tutorials](http://en.michaeluno.jp/admin-page-framework/tutorials-v3/)
- [FAQ](https://wordpress.org/plugins/admin-page-framework/faq/)
- [Other Notes](https://wordpress.org/plugins/admin-page-framework/other_notes/)
- [Change Log](https://wordpress.org/plugins/admin-page-framework/changelog/)
### Getting Helped
- [Support Forum](http://wordpress.org/support/plugin/admin-page-framework)
## Framework Core Development
You would need to access the code of the core files to add modifications. The downloadable zip file does not include core files but the complied library files only.
### Getting Core Files
In order to modify the framework development files, clone the repository files. Simply clone the repository from either of the following addresses.
ssh:
```
git@github.com:michaeluno/admin-page-framework.git
```
https:
```
https://github.com/michaeluno/admin-page-framework.git
```
With [Composer](https://getcomposer.org/), create a `composer.json` file with the following contents and perform `php composer.phar install`.
```
{
"require": {
"michaeluno/admin-page-framework": "dev-master"
}
}
```
### Adding Modifications to the Framework Core
The core files are located in the `development` directory.
1. Make sure the constant `WP_DEBUG` is set to `true` in the `wp-config.php` file of your development site. If this is `false`, the loader plugin will load the complied files in the `library` directory.
2. Modify the core files and make sure your changes take effect.
3. If you add class files, make sure to run `run.sh` in `tool/inclusion_class_list` to generate inclusion file lists.
4. After all the modifications are done, run `run.sh` in `tool/beautifier` to compile the files.
## Contributions
Anyone is welcome to contribute to *Admin Page Framework*. There are various ways you can contribute:
- Report [bugs](https://github.com/michaeluno/admin-page-framework/issues).
- Post ideas on [enhancements](https://github.com/michaeluno/admin-page-framework/issues?direction=desc&labels=Enhancement&page=1&sort=created&state=open).
- Send us a Pull Request with your bug fixes and/or new features.
- Write a [custom field type](http://admin-page-framework.michaeluno.jp/en/v3/package-AdminPageFramework.FieldType.html).
- Write [test cases](test/readme.md).
- Improve the [documentation](https://github.com/michaeluno/admin-page-framework/blob/master/documentation_guideline.md).
- Tweak the styling of the framework page elements.
- Translate the language files in the [language](https://github.com/michaeluno/admin-page-framework/tree/master/language) directory to your native language.
- Possibly more.
### Supporting Future Development
If you like the library, please rate and review it in the [WordPress Plugin Directory](http://wordpress.org/support/view/plugin-reviews/admin-page-framework?filter=5). Also donation would be greatly appreciated. Thank you!
[](http://en.michaeluno.jp/donate)
## Copyright and License
### Admin Page Framework (Framework Files)
[MIT license](development/LICENSE.txt)
### Admin Page Framework - Loader (WordPress Plugin)
[GPL v2](./LICENSE.txt)