Download the PHP package dotkernel/admin without Composer

Dotkernel Admin

Dotkernel Admin is an application (skeleton) intended for quickly setting up an administration site for your platform. It's a fast and reliable way to manage records in your database with a simple table-based approach, and also to build reports and graphs to monitor your platform. The many graphical components at your disposal ensure an intuitive user experience.

Check out our demo.

Submit user admin and password dotadmin to authenticate yourself.

Documentation

Documentation is available at: https://docs.dotkernel.org/admin-documentation/

Badges

Getting Started

Clone the project

Using your terminal, navigate inside the directory you want to download the project files into. Make sure that the directory is empty before proceeding to the download process. Once there, run the following command:

Install the project dependencies

You will be prompted with the below message to choose whether you want to inject ConfigProviders:

Type 0 to select [0] Do not inject and hit Enter.

We choose not to inject any ConfigProvider because Dotkernel Admin comes with all the required ConfigProviders already injected in config/config.php. Choosing to inject any extra ConfigProvider would cause having duplicates which are not allowed and would crash the application.

Development mode

Do not enable development mode in production!

If you're installing the project for development, you should enable development mode by running:

You can disable development mode by running:

You can check the development status by running:

Prepare config files

• optional: to run/create tests, duplicate config/autoload/local.test.php.dist as config/autoload/local.test.php <- this creates a new in-memory database that your tests will run on

Setup database

Use an existing empty one or create a new MariaDB/MySQL database.

Recommended collation: utf8mb4_general_ci.

Running migrations

• fill out the database connection params in config/autoload/local.php under $databases['default']
• run the database migrations by using the following command:

This command will prompt you to confirm that you want to run it:

WARNING! You are about to execute a migration in database "<database>" that could result in schema changes and data loss. Are you sure you wish to continue? (yes/no) [yes]:

Hit Enter to confirm the operation.

Executing fixtures

Fixtures are used to seed the database with initial values and must be executed after migrating the database.

To list all the fixtures, run:

This will output all the fixtures in the order of execution.

To execute all fixtures, run:

To execute a specific fixture, run:

More details on how fixtures work can be found in dotkernel/dot-data-fixtures documentation.

Mail configuration

If your application sends emails, you must configure an outgoing mail server under config/autoload/mail.global.php.

Sync GeoLite2 databases

Full sync

You can download/update all GeoLite2 databases at once by running the following command:

The output should be similar to the below:

Selective sync

You can download/update a specific GeoLite2 database by running the following command:

Where <database> takes one of the following values: asn, city, country.

Get help for this command by running:

If you set up the synchronizer command as a cronjob, you can add the -q|--quiet option, and it will output data only if an error has occurred.

NPM Commands

To install dependencies into the node_modules directory run this command:

If the above command fails, it could be caused by user permissions of npm. Recommendation is to install npm through Node Version Manager.

The watch command looks for JavaScript/CSS file changes and recompiles the assets under the public assets:

Once finished working on the JavaScript/CSS files, run the below command to minify the public assets and prepare them for production:

Test the installation

If you are using virtual hosts as described in the [Dotkernel documentation] (https://docs.dotkernel.org/development/), you need to modify the permissions of the data, public/uploads and log folders:

Run the following command in your project's directory to start PHPs built-in server:

Running command composer serve will do the same thing, but the server will time out after a couple of minutes.

If you are still getting exceptions or errors regarding some missing services, try running the following command:

Open a web browser and visit http://localhost:8080/.

You should see the Dotkernel Admin login page. If you ran the migrations you will have an admin user in the database with the following credentials:

• Identity: admin
• Password: dotadmin

[!WARNING] Production only

Make sure you modify the default admin credentials.

[!WARNING] Development only

session.cookie_secure does not work locally so make sure you modify your local.php, as per the following:

Do not change this in local.php.dist as well because this value must remain true on production.