Grav Admin Plugin
This admin plugin for Grav is an HTML user interface that provides a convenient way to configure Grav and easily create and modify pages. This will remain a totally optional plugin, and is not in any way required or needed to use Grav effectively. In fact, the admin provides an intentionally limited view to ensure it remains easy to use and not overwhelming. I'm sure power users will still prefer to work with the configuration files directly.
We have tested internally, but we hope to use this public beta phase to identify, isolate, and fix issues related to the plugin to ensure it is as solid and reliable as possible.
For live chatting, please use the dedicated Slack Chat Room for discussions directly related to Grav.
For bugs, features, improvements, please ensure you create issues in the admin plugin GitHub repository.
First ensure you are running the latest Grav 1.6.7 or later. This is required for the admin plugin to run properly (
-fforces a refresh of the GPM index).
$ bin/gpm selfupgrade -f
The admin plugin actually requires the help of 3 other plugins, so to get the admin plugin to work you first need to install admin, login, forms, and email plugins. These are available via GPM, and because the plugin has dependencies you just need to proceed and install the admin plugin, and agree when prompted to install the others:
$ bin/gpm install admin
Manual installation is not the recommended method of installation, however, it is still possible to install the admin plugin manually. Basically, you need to download each of the following plugins individually:
Extract each archive file into your
user/pluginsfolder, then ensure the folders are renamed to just
email/. Then proceed with the Usage instructions below.
After this you need to create a user account with admin privileges:
$ bin/plugin login new-user
Alternatively, you can create a user account manually, in a file called
user/accounts/admin.yaml. This filename is actually the username that you will use to login. The contents will contain the other information for the user.
password: 'password' email: '[email protected]' fullname: 'Johnny Appleseed' title: 'Site Administrator' access: admin: login: true super: true
Of course you should edit your
titleto suit your needs.
You can use any password when you manually put it in this.yamlfile. However, when you change your password in the admin, it must contain at least one number and one uppercase and lowercase letter, and at least 8 or more characters.
By default, you can access the admin by pointing your browser to
http://yoursite.com/admin. You can simply log in with the
passwordset in the YAML file you configured earlier.
After logging in, your plaintext password will be removed and replaced by an encrypted one.
The standard free version, is very powerful, and has more functionality than most commercial flat-file CMS systems.
We also intend to release in the near future a more feature-rich pro version that will include enhanced functionality, as well as some additional nice-to-have capabilities. This pro version will be a paid plugin the price of which is not yet 100% finalized.
First install the dev dependencies by running
composer updatefrom the Grav root. Then
composer testwill run the Unit Tests, which should be always executed successfully on any site.