A WordPress plugin for static site generation and deployment.
Looking for the older style plugin? It's been renamed and improved as Static HTML Output.
WP2Static is an open source project, maintained by many generous developers over the years, including, but not limited to these contributors on GitHub. Source code for this core repository and all addons shall always remain publicly available.
Read about WP2Static's developers, contributors, supporters.
develop
branch is considered unstable with latest code changes (current build status: ).
develop
branch should always have a -dev
WordPress plugin version, ie 7.1.1-dev
.
master
branch should always reflect a stable release, such as 7.1.1
, which should have a matching tag.
Please don't be intimidated to contribute code to this project. I welcome code in any way you're comfortable to contribute it (email, forum, diff). If you're new to GitHub and this kind of thing, the below guide may help you.
- Fork project with button in top of WP2static github home page
- Clone your project to your development computer (please, change by your account name):
git clone https://github.com/<your-account>/wp2static.git
- Fork your new branch from develop naming with:
- If you want add new feature:
feature-<name of your feature>
- If you want to fix a bug:
bug-<name of bug>
git checkout -b feature-myfeature
- If you want add new feature:
- Do your commits
- Push to your repository
git push origin feature-myfeature
- Then go to your https://github.com//wp2static site and create a pull request:
In base repository choose leonstafford/wp2static and choose development branch. - After Pull Request is approved you need to sync repositories.
- In your local development add upstream branch:
git remote add upstream https://github.com/leonstafford/wp2static
- Fetch upstream
git fetch upstream
- Checkout your local branch:
git checkout develop
- Merge upstream with your local:
git merge upstream/develop
- You can now make new branches.
Fork project WP2static home page
git clone https://github.com/ebavs/wp2static.git # clone repository (please,change ebavs by yours, this is only an example)
Then add WP2Static remote
git remote add upstream https://github.com/leonstafford/wp2static # add remote
git checkout -b feature-newdocumentation # create new branch to do changes
git commit -am "my new commits" # send new changes
git push origin feature-myfeature # push to your repository
Then Pull Request in WP2Static
git fetch upstream # download commits from wp2static repo
git checkout develop # change to local develop branch
git merge upstream/develop # merge with wpstatic develop branch
This is currently done by @leonstafford and involves these steps:
- test code in
develop
branch - set a new dev version if needed, ie
7.1.1-dev
- merge
develop
branch tomaster
- adjust
wp2static.php
version to non-dev, ie7.1.1
- update
CHANGELOG.md
- create new git tag with matching version
- push
master
branch and tag to GitHub - create new Release in GitHub with same notes as CHANGELOG
- build zip installer and publish to wp2static.com with MD5 hash