Download the PHP package digiants-agency/fastadminpanel without Composer

Contents

• Intro
• Getting started
• Concept
• Usage CRUD
• Usage Static content generator
• Auto documentation
• Dropdown menu
• Multilanguage
• How to
  • Open dev menu
  • Change permissions
  • Add custom page
  • Override field template
  • Override CRUD service

Intro

Open-source free FastAdminPanel CRUD generator

The open-source headless CMS made with Laravel and Vue.js, flexible and fully customizable.

FastAdminPanel is a free and open-source headless multilangual CMS enabling you to manage any content.

Multilanguage CRUD generator with relations (15 field types) + models + migrations + documented api, static content generator

• Modern Admin Panel: Elegant, entirely customizable and a fully extensible admin panel.
• Customizable: You can quickly build your logic by fully customizing APIs, routes, or plugins to fit your needs perfectly.
• Blazing Fast and Robust: Built on top of Laravel and Vue.js, FastAdminPanel delivers reliable and solid performance.
• Front-end Agnostic: Use any front-end framework (React, Next.js, Vue, Angular, etc.), mobile apps or even IoT.

You can find some screenshots below.

Feel free to contact me: [email protected]

Getting Started

⏳ Installation

• Install Laravel first

• Go inside the folder

• Use the composer to install the FastAdminPanel project

• Configure DB and APP_URL in the .env file

• Run the install command

• Publish the packages config and assets (below laravel filemanager installation)

• In "config/lfm.php"

• Add disk "config/filesystems.php"

Enjoy 🎉

Concept

• You can generate CRUDs with this package. The package also automatically creates model files with relations and migrations (they are also added when updating or deleting CRUDs).
• Data about dropdown list, permissions and CRUDs are stored in json files, path = "/storage/app/ENTITY.json" (so this information will end up on the git).
• You have the ability to create “single” entities to manage static content.
• The admin panel is fully multi-lingual. CRUD multilingualism is represented as identical tables in different languages, e.g. post_en, post_de. This approach denormalizes the database (increasing the amount of space occupied), but makes a very simple approach to manage it. The multilanguage model is very simple and is represented by the MultilanguageModel class.
• The admin panel is written without using npm or other such technologies, allowing it to be edited without reassembling.

Usage of CRUD generator

• Go to https://yourdomain.com/admin/cruds
• Fill the fields:
  • CRUD name - the table name for the DB
  • CRUD title - the title for the menu
  • Is dev - the option to hide CRUD from menu (see more Open dev menu)
  • Multilanguage - the option to enable multilanguage (see more Multilanguage)
  • Is docs - the option to show this CRUD in the auto generated documentation (see more Documentation)
  • Show statistics - the option to show this CRUD in the dashboard
  • Model - auto generated (there is no need to fill on creation) path to model. If you change path to generated model, you must change this field
  • Default order - field database title to set default sort order in the list of the entities
  • Sort - sort order in the menu
  • Dropdown - set parent menu item (see more Dropdown menu)
  • Icon - set icon for the menu
  • Fields - set of fields that appear in your CRUD (15 types of the fields)
• Press the button "Create"
• Now you can create Controller and use generated Model in it. Or you can go to /fapi/{crud_slug}

Notes:

• All the data about CRUDs is stored in /storage/app/cruds.json (so this information will end up on the git)
• If you want to move the generated model from the default folder - you need to edit the Model field in the model in CRUD properly.
• If you DON'T want to edit the model automatically when you change the CRUD - you just need to remove the Model field in the CRUD (but this will break /fapi/{model}/{id}).
• To add permissions for the automatic API, you need to go to /admin/settings
• There is an option in /config/fap.php - "migrations_mode". It determines how the admin panel handles migrations:
  • "dev":
  • if you delete CRUD - old migration will be DELETED
  • if you update CRUD - old migration will be OVERWRITTEN
  • "prod":
  • if you delete CRUD - new migration will be ADDED
  • if you update CRUD - new migration will be ADDED

You can see the examples below:

• Creation:

• List:

• Edit:

Usage of Static content generator

• Go to https://yourdomain.com/admin/singles
• Fill the fields:
  • Single name - inner ID for the API and usage in the code
  • Single title - title for the menu
  • Sort - sort order
  • Dropdown - parent menu item (see more Dropdown menu)
  • Icon - icon for the menu
• Press the button "Create"

• Now you can use it in the code like that:

• Or you can go to /fapi/singles/{your_slug_here}. Do not forget about permissions

You can see the examples below:

• Creation:

• Edit:

Auto documentation

Every CRUD created that has “Is docs” = Yes is displayed in the documentation. Also all static content “single” is displayed in the documentation.

• Documentation can be viewed at https://yourdomain.com/admin/docs.

• If you want to add your own documentation, go to /app/FastAdminPanel/Controllers/DocsController.php. There's already an example of how to write it

You can see the example of the documentation below:

Dropdown menu

You can add a parent menu item for the singles and CRUDs you create.

• Go to: https://yourdomain.com/admin/dropdowns

• Add dropdowns

• Go to CRUD or single (static content generator) and add parent

You can see the example of the dropdown below:

Multilanguage

• The admin panel is fully multi-lingual. CRUD multilingualism is represented as identical tables in different languages, e.g. post_en, post_de. This approach denormalizes the database (increasing the amount of space occupied), but makes a very simple approach to manage it. The multilanguage model is very simple and is represented by the MultilanguageModel class.

• To make the custom model multilingual - just inherit the App\FastAdminPanel\Models\MultilanguageModel class.

• There is "Multilanguage" select in CRUD to make it multilangual.

• Each field has a Lang column to make it multi-lingual. If Lang == “common”, then when saving the field - the value will be updated in all the tables (for example posts_en, posts_de, posts_fr). If Lang == “separate”, then when saving the field - the value will be updated in the current language table only (for example posts_en).

• You can edit languages at https://yourdomain.com/admin/settings.

• The language of the admin panel is represented in the “admin_lang_tag” column of the User.

• There is a class Lang. It has several useful methods:

How to

Open dev menu

• By default, internal settings for permissions, languages, crud, single and dropdown are hidden.

• All hidden menu items are displayed if APP_DEBUG=true in the .env file.

• You can also hide CRUDs ("Is dev" option).

• To show hidden menu items, you need to add "?dev=" to your address, for example: https://yourdomain.com/admin?dev=.

• To change query parameter, go to: /config/fap.php

Change permissions

• Go to https://yourdomain.com/admin/cruds/roles to add roles.

• Each role has the “Is admin” option that allows the role to log into the admin panel.

• Go to https://yourdomain.com/admin/settings to change role permissions.

• Warning: be careful with relations. Someone can use a GET method with a relation (and the relation will not be checked for permission).

• Superadmin role is: Entities = all, All = true.

Add custom page

• The example below exists, but it is commented out (https://github.com/digiants-agency/fastadminpanel/commit/5d6f2eb4bab58cebe1ddfc9a4a66f7e18e95a51b).

• Create Vue component. For example:

• Include your page in the app. The app is here:

• Place your include after the dashboard:

• Add Vue route in the app after the dashboard:

• Add menu item to the sidebar (after menu v-for). The sidebar is here:

Override field template

• Create your field by this rule and it will be applied accordingly:

• FIELD_TYPE - the type of the field, for example: ckeditor, date etc.

• TABLE_NAME - the name of the CRUD table (place the word "all" for all tables)

• DB_TITLE - the title in the database of the field (place the word "all" for all fields)

Some examples already exist in the "custom" folder.

Override CRUD service

• Add your own CRUD service to override some methods: index, show, store, update, copy, destroy.

• One such service already exists as example.

• Create your service here:

• Add your service to the provider:

• Here:

• The example above shows an override of the “show” method of the “products” table.