Shifter does support custom Themes, but when developing custom WordPress Themes on Shifter there are a few tips and notes that can help make the process easier.
Custom Theme Workflow
The Ideal custom WordPress Theme Setup:
-
Develop Locally using Shifter-Local
-
Migrate your DB changes and Uploads using AIO WP Migration if necessary
-
Track Theme changes via Git
-
Deploy Theme changes tracked in Git with our Github integration plugin.
On this instruction we use our sample repository: shifter-github-hosting-tehem-samlple . We welcome your clone to local or fork.
1. [Github] Create repository for your theme or plugin, or fork our sample repository
![](/wp-content/uploads/2024/03/192144287-114e1e16d70f8eb457884885.png)
If you’ve forked our sample repository, make sure release.yml
is available.
![](/wp-content/uploads/2024/03/192145232-e4b8d41d04a6b7bdc769ab8f.png)
2. [Github] Enable Github Action on the repository
Click [I understand my workflows, go ahead and run them] button
![](/wp-content/uploads/2024/03/192145499-ba5732432f172acf105cb8e9.png)
“Github Actions” are enabled.
![](/wp-content/uploads/2024/03/192145778-95dd61947399e15915a56ba7.png)
3. Create a new workflow or use our sample workflow (release.yml)
-
Click [New workflow] button
-
Click [Set up workflow yourself]
-
Create workflow file, and save
If you’ve forked our sample repository, make sure release.yml
is available.
![](/wp-content/uploads/2024/03/192145232-e4b8d41d04a6b7bdc769ab8f.png)
4. [Github] Clone the repository to local
$ git clone git@github.com:YOUR-ACCOUNT/YOUR-REPOSITORY.git ~/git/YOUR-REPOSITORY
![](/wp-content/uploads/2024/03/192156169-3c645895b75bc0d3e032df44.png)
5. [Github] Copy the repository’s URL
![](/wp-content/uploads/2024/03/192155910-834c1640580b8e4e80fe05d7.png)
6. [Shifter] Start WordPress and login to it
7. [Shifter] Install theme/plugin through custom Theme into Shifter
Navigate to [Appearance] –> [Add New fro Github]
![](/wp-content/uploads/2024/03/192165787-980917e7fca3fc174321dafd.png)
8. Install Plugin or Theme with Shifter Github Theme/Plugin installer
Paste your Github’s repository URL to [GitHub repo URL] field.
If your repository is private, also input access token to [GitHub token].
Then click [Install Now].
![](/wp-content/uploads/2024/03/192166718-3e3fcc2049e443554cad2ed4.png)
9. [Shifter] Confirm installed
![](/wp-content/uploads/2024/03/192168009-aa6da46101a2ec15f433e26a.png)
10. [Github] Create release package with a tag and deploy
After some update on the repository, create release package and deploy.
CLI
$ git tag 2
$ git push origin 2
Web Browser
1. Navigate to [releases] under [Code] tab
![](/wp-content/uploads/2024/03/192169193-b003148f56b0565df60ab66a.png)
2. Click [Draft a new release] button
![](/wp-content/uploads/2024/03/192169545-24c4bbc00a8ce4faf65eeeca.png)
3. Input version number to [Tag version] field then click [Publish Release]
![](/wp-content/uploads/2024/03/192169990-94e1e4cc33e06ba7e4d44422.png)
11. Back to [Actions] tab, and make sure Github Actions worked
It may take a couple minutes to complete.
![](/wp-content/uploads/2024/03/192170962-4abd583e871f32350c80c7c8.png)
![](/wp-content/uploads/2024/03/192170613-0103e71108ce45573f805691.png)
12. [Shifter] Re-Login to Shifter and navigate to update page to confirm it’s ready to update
![](/wp-content/uploads/2024/03/192171486-1590e79dcb2b5cd768deeacb.png)
13. [Shifter] Apply update and confirm it works
14. [Shifter] Generate and deploy an Artifact