Download the PHP package edalzell/forma without Composer

On this page you can find all versions of the php package edalzell/forma. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package forma

Give your Statamic addons a beautiful configuration page in the control panel

Latest Version

This package provides an easy way to let users configure your addon.

Requirements

Installation

You can install this package via composer using:

The package will automatically register itself.

Usage

First, create a config.yaml file in resources\blueprints that contains the blueprint for your configuration. As an example, see Mailchimp's, here.

Then, in the bootAddon method of your addon's Service Provider add:

The second parameter is optional and only needed if you need custom config handling (see Extending below)

There is a 3rd parameter handle you can use if the config file is NOT the addon's handle.

Once you do that, you get a menu item in the cp that your users can access and use. All data is saved into your addon_handle.php (or $handle as per above) in the config folder.

menu item

Permissions

There is a Manage Addon Settings permission that must be enabled to allow a user to update the settings of any Forma-enabled addons.

Extending

If your addon needs to wangjangle the config before loading and after saving, create your own controller that extends \Edalzell\Forma\ConfigController and use the preProcess and postProcess methods.

For example, the Mailchimp addon stores a config like this:

But there is no Blueprint that supports that, so it uses a grid, which expects the data to look like:

Therefore in its ConfigController:

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

License

MIT License


All versions of forma with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
laravel/framework Version ^10.0 || ^11.0 || ^12.0
statamic/cms Version ^4.0 || ^5.0
stillat/proteus Version ^4.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package edalzell/forma contains the following files

Loading the files please wait ....