-
Notifications
You must be signed in to change notification settings - Fork 7
Changing forum theme and plugins
The forum uses git submodules to manage plugins and themes. These are distinct git repos that are pulled in when the forums repo is cloned through the git clone --recursive
command.
For instance, at the time of this writing, the forums repo has 4 submodules listed in .gitmodules:
[submodule "themes/bootstrap"]
path = themes/bootstrap
url = https://github.com/29th/vanilla-bootstrap.git
[submodule "plugins/PersonnelFiles"]
path = plugins/PersonnelFiles
url = https://github.com/29th/vanilla-personnelfiles.git
[submodule "plugins/bootstrapmarkdown"]
path = plugins/bootstrapmarkdown
url = https://github.com/29th/vanilla-bootstrapmarkdown.git
[submodule "plugins/MarkdownMarkup"]
path = plugins/MarkdownMarkup
url = https://github.com/29th/vanilla-markdownmarkup.git
When the forums repo is cloned with the --recursive
argument, git also clones the submodules in the .gitmodules
file into the paths specified.
To make changes to the plugins/theme, modify it in its repository first (through the normal fork & pull request workflow), then run the following command from inside the forums repo to update the submodules:
git submodule foreach git pull origin master
Finally, commit your update from inside the forums directory and push your changes to the forums repo via the normal fork & pull request workflow.
Because the forums do not have a continuous integration workflow setup with the production server, you will also need to pull the changes down into the production server. First, backup the forums directory on the production server, and then from inside the forums directory on the server:
git pull origin 29th-extensions-2.x.x