Skip to content

Changing forum theme and plugins

wilson29thid edited this page Feb 17, 2016 · 9 revisions

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
Clone this wiki locally