nodebb-theme-project-x v0.0.23
nodebb-custom-theme
Installation
Please, follow the default instuction for the theme - https://docs.nodebb.org/development/themes/
The name of the theme is "nodebb-theme-project-x"
npm install nodebb-theme-project-x
There are also needed action from administration section to set appropriate icons:
- activate theme in the admin interface (/admin/appearance/themes)
- forum name and logo (/admin/settings/general)
- set favicon (/admin/settings/general)
- icons for categories (/admin/manage/categories/1)
- subcategories (/admin/manage/categories)
- switch on search plugin (forum upgrade process is needed)
- header menu items (right now the default ones are used) - /admin/general/navigation
- turn off RSS icons near category title (/admin/settings/web-crawler)
Local development
To locally develop the theme you need the full nodebb installation (with mongo db or without)
To change theme name you need to change the theme name in the following files:
- package.json
- theme.json
- less/common.less and other less files (the theme name is used as image path part )
To change the theme source file and see changes in on the local forum instance it is possible to use npm link mechanism.
Deployment
It is only way to deploy theme to server - is using the standard mechanism:
npm install nodebb-theme-project-x
The method with npm link will break ./nodebb upgrage script because it uses npm install --production inside which doesnt support the npm link
The simple copy file to directory node_modules/nodebb-theme-custom-theme is also is not working in case of npm upgrade
Forum Administration
Changing name/ logo
SETTINGS > GENERAL
Change Site Title
In the "Site Logo" section "Image field" choose "UPLOAD".
Change Language:
General(Общие) > Languages (Языки)> Русский
Adding a category
To add a category click "+" icon at the bottom left of the screen
To add children-categories
To add new sub-category click on the '+' sign in Manage (Управление) > Categories (Категории).
Then add title of sub-category in Category Name field.
Then in the (Optional) Parent Category field define the category where you want your subcategory to show up in the form of rounded thumbnail.
Change category icons
Manage (Управление) > Categories (Категории) > Edit (Редактировать)
In the "Edit" tab choose UPLOAD IMAGE in the right side. You can find all necessary icons in static/icons folder;
Set the following rules at the left side of page:
Background Colour' -#d7d7d7`Background Image Size-cover
To turn off "RSS" icon and functionality
SETTINGS (Настройки) > Web Crawler (Индексация)
And switch Disable RSS Feeds to the active mode;
How to turn on "search"
Go to EXTEND > Plugins
Find nodebb-plugin-dbsearch and install or activate it.
After installation you probably need to upgrade your nodebb.
Subcategories The colored bullets
What are the colored bullets under almost each "Category"
The answer is here: https://www.sportbikes.ws/;
These are the "subcategories" (children-topics)
Troubleshooting
reset theme
Sometimes during theme development you need to change the theme name. It can break a lot of things so it needs to reset theme to default one
./nodebb reset -t
upgrade (from one forum version to another)
./nodebb upgrade
Under the hood, upgrade is making npm install --production so it is not possible to use npm link to install the theme