π Quick Start β BakeKit CMS¶
Welcome to BakeKit CMS! This quick start guide will help you get up and running in minutes.
This guide assumes you've already downloaded or cloned BakeKit CMS from GitHub and have it running in a local development environment.
π§° Site Management Panel¶
Once launched, youβll see a clean dashboard. All features in BakeKit CMS are plugin-based, so nothing is enabled by default.
At the top of the dashboard, there are two predefined region placeholders:
- [plugins-menu] β For menus populated with plugin links (Pages, Blog, etc.)
- [custom-menu] β For menus with custom links
To begin configuring your site, click the βοΈ cogs icon in the top-right corner of the dashboard to access the Site Management Panel, where you can:
- Manage Plugins, Themes, Regions, Menus, Roles, Users, Meta, and Settings
π§© 1. Load a Plugin¶
To enable features like static pages, blog posts, or slideshows, you need to install and activate plugins.
π Tip: Start by installing the FileManager plugin β itβs required by other plugins for image handling.
Install via Git:
git clone https://github.com/bakewizard/FileManager.git
zip -r FileManager.zip FileManager
rm -rf FileManager
- Go to the Plugins page and click Browse.
- Upload the FileManager.zip file.
- Click Install, then Activate.
π§ 2. Add a Menu¶
- Navigate to the Menus page.
- Click the β icon to create a new menu.
- Fill in the fields:
- Name:
Admin left accordion menu
- Description:
Admin plugins menu
- Client: Select
Backend
. - Enabled: β Checked.
- Name:
- Click Save & Close.
The menu will appear in the Menus page:
To add links to the menu:
- In the Actions column, click the first button to manage menu links.
- Click the β icon to add a new link.
- Fill in the fields:
- Title:
FileManager
- Icon: Enter a Bootstrap or FontAwesome class (e.g., bi-folder, fa fa-file)
- Click the Link button and choose Plugin page from the accordion.
- Title:
- Click Save & Close.
The new link will be added to the menu:
π§± 3. Add a Region with a Block¶
To render the admin menu in your layout:
- Go to Regions & Blocks.
- Click the β icon to create a new region.
- Enter the details:
- Alias:
plugins-menu
(must match the placeholder name). - Description:
Plugins menu region
.
- Alias:
- Click Save & Close.
The region will now appear in the list:
To add a block to the region:
- In the Actions column, click the first button to manage blocks.
- Click the β icon to create a block.
- Fill in the details:
- Alias:
plugins-menu-block
(must be a unique identifier: a-z, 0-9, -). - Title:
Plugins menu block
. - Description:
Plugins menu block containing plugins menu
. - Click the Cell button and choose 'Menu cell' from the accordion.
- Enabled: β Checked.
- Alias:
- Click Save & Close.
Finally, configure the new block:
- In the Actions column, click the βοΈ icon.
- Select Admin left accordion menu from the dropdown.
- Click Save.
You should now see the FileManager link in the admin sidebar.
π¦ 4. Load a Theme¶
To install and activate a new theme:
- Go to the Themes page.
- Click Browse and select the theme
.zip
file. - Click Install, then Activate.
π‘ Alternatively, unzip a theme manually into the /themes directory. It will appear in the theme list for activation.
π οΈ Next Steps¶
BakeKit CMS is now set up!
You can now: