-
Notifications
You must be signed in to change notification settings - Fork 30
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Move developer docs into separate file
- Loading branch information
1 parent
153ddbf
commit d50b61e
Showing
2 changed files
with
101 additions
and
102 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -118,107 +118,7 @@ To get write access to the GitHub repo, please reach out to our **GitHub Adminis | |
|
|
||
| To get access to [GatherPress.org](htps://gatherpress.org/get-involved) via SSH or WP Admin login, please reach out to our **GatherPress.org Administrator**: [Mervin Hernandez](https://github.com/MervinHernandez). | ||
|
|
||
| ## Developer Documentation | ||
| ### Read Developer Documentation | ||
|
|
||
| ### .wp-env | ||
| Find the developer documentation inside the plugins' `docs` folder. | ||
|
|
||
| If you have Docker installed, you could use the `wp-env` package to load a WordPress development environment with this plugin automatically activated. | ||
|
|
||
| ### Local Development | ||
|
|
||
| #### Fork this repository | ||
|
|
||
| Although you can download a zip file of the plugin at: | ||
|
|
||
| ``` | ||
| https://github.com/GatherPress/gatherpress | ||
| ``` | ||
|
|
||
| If you want to help out with development, we suggest forking the code to your own Github repository and creating a branch from there. | ||
|
|
||
| #### Clone this repository | ||
|
|
||
| Once you've forked the repo, you should now have a mirrored copy of GatherPress, but on your profile's URL, or something like this: | ||
|
|
||
| ``` | ||
| https://github.com/YourGithubUsername/gatherpress | ||
| ``` | ||
|
|
||
| where `YourGithubUsername` corresponds to your login name for Github. | ||
|
|
||
| To clone a local copy, open a terminal window and run the following command: | ||
|
|
||
| ```sh | ||
| git clone [email protected]:YourGithubUsername/gatherpress.git | ||
| ``` | ||
|
|
||
| if you have your SSH keys set up. If not, run: | ||
|
|
||
| ```sh | ||
| git clone https://github.com/YourGithubUsername/gatherpress.git | ||
| ``` | ||
|
|
||
| ##### Note about customizing the URL | ||
|
|
||
| Once you have forked the GatherPress repo, you can also change the folder name of your version of the repository by going into your settings of your repo on Github's website. | ||
|
|
||
| ``` | ||
| https://github.com/pbrocks/gatherpress | ||
| ``` | ||
|
|
||
|  | ||
|
|
||
| ### Install wp-env globally | ||
|
|
||
| In a terminal window, run: | ||
|
|
||
| ```sh | ||
| npm i -g @wordpress/env | ||
| ``` | ||
|
|
||
| #### Change directory and run wp-env | ||
|
|
||
| In your terminal window, run: | ||
|
|
||
| ```sh | ||
| cd gatherpress | ||
| wp-env start | ||
| ``` | ||
|
|
||
| You should then see that a development site has been configured for you on localhost port 2003 | ||
|
|
||
|  | ||
|
|
||
| #### Log in to Site / Log into Site | ||
|
|
||
|  | ||
|
|
||
| #### Development Site Plugins/Themes | ||
|
|
||
| To further customize the development site using your favorite or most familiar development plugins or themes, you are able to add whatever you like because of this code added to the `.wp-env.json` file: | ||
|
|
||
| ```json | ||
| "mappings": { | ||
| "wp-content/plugins": "./wp-core/plugins", | ||
| "wp-content/themes": "./wp-core/themes" | ||
| }, | ||
| ``` | ||
|
|
||
| In fact, after the initial setup, you may notice that in your code editor, there is now a `wp-core` folder containing the default plugins and themes, but it is grayed out, so the contents of this folder will not be committed to the GatherPress repository. | ||
|
|
||
|  | ||
|
|
||
| #### To shut down your development session | ||
|
|
||
| Simply run: | ||
|
|
||
| ```sh | ||
| wp-env stop | ||
| ``` | ||
|
|
||
| For more info on wp-env package, consult the [Block Handbook's page](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/). | ||
|
|
||
| ## Credits | ||
|
|
||
| Thanks to the following folks for contributing to GatherPress: | ||
| [mauteri](https://profiles.wordpress.org/mauteri/), [hrmervin](https://profiles.wordpress.org/hrmervin/), [pbrocks](https://profiles.wordpress.org/pbrocks/), [jmarx](https://profiles.wordpress.org/jmarx/), [prashantabellad](https://profiles.wordpress.org/prashantabellad/), [prayagm](https://profiles.wordpress.org/prayagm/), [patricia70](https://profiles.wordpress.org/patricia70/), [meaganhanes](https://profiles.wordpress.org/meaganhanes/), [calebthedev](https://profiles.wordpress.org/calebthedev/), [javiercasares](https://profiles.wordpress.org/javiercasares/), [linusx007](https://profiles.wordpress.org/linusx007/), [cameronbarrett](https://profiles.wordpress.org/cameronbarrett/), [courane01](https://profiles.wordpress.org/courane01/), [newyorkerlaura](https://profiles.wordpress.org/newyorkerlaura/), [phoopee3](https://profiles.wordpress.org/phoopee3/), [hauvong](https://profiles.wordpress.org/hauvong/), [deshabhishek007](https://profiles.wordpress.org/deshabhishek007/), [jeffpaul](https://profiles.wordpress.org/jeffpaul/), [michelleames](https://profiles.wordpress.org/michelleames/) | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,99 @@ | ||
| ## Developer Documentation | ||
|
|
||
| ### .wp-env | ||
|
|
||
| If you have Docker installed, you could use the `wp-env` package to load a WordPress development environment with this plugin automatically activated. | ||
|
|
||
| ### Local Development | ||
|
|
||
| #### Fork this repository | ||
|
|
||
| Although you can download a zip file of the plugin at: | ||
|
|
||
| ``` | ||
| https://github.com/GatherPress/gatherpress | ||
| ``` | ||
|
|
||
| If you want to help out with development, we suggest forking the code to your own Github repository and creating a branch from there. | ||
|
|
||
| #### Clone this repository | ||
|
|
||
| Once you've forked the repo, you should now have a mirrored copy of GatherPress, but on your profile's URL, or something like this: | ||
|
|
||
| ``` | ||
| https://github.com/YourGithubUsername/gatherpress | ||
| ``` | ||
|
|
||
| where `YourGithubUsername` corresponds to your login name for Github. | ||
|
|
||
| To clone a local copy, open a terminal window and run the following command: | ||
|
|
||
| ```sh | ||
| git clone [email protected]:YourGithubUsername/gatherpress.git | ||
| ``` | ||
|
|
||
| if you have your SSH keys set up. If not, run: | ||
|
|
||
| ```sh | ||
| git clone https://github.com/YourGithubUsername/gatherpress.git | ||
| ``` | ||
|
|
||
| ##### Note about customizing the URL | ||
|
|
||
| Once you have forked the GatherPress repo, you can also change the folder name of your version of the repository by going into your settings of your repo on Github's website. | ||
|
|
||
| ``` | ||
| https://github.com/pbrocks/gatherpress | ||
| ``` | ||
|
|
||
|  | ||
|
|
||
| ### Install wp-env globally | ||
|
|
||
| In a terminal window, run: | ||
|
|
||
| ```sh | ||
| npm i -g @wordpress/env | ||
| ``` | ||
|
|
||
| #### Change directory and run wp-env | ||
|
|
||
| In your terminal window, run: | ||
|
|
||
| ```sh | ||
| cd gatherpress | ||
| wp-env start | ||
| ``` | ||
|
|
||
| You should then see that a development site has been configured for you on localhost port 2003 | ||
|
|
||
|  | ||
|
|
||
| #### Log in to Site / Log into Site | ||
|
|
||
|  | ||
|
|
||
| #### Development Site Plugins/Themes | ||
|
|
||
| To further customize the development site using your favorite or most familiar development plugins or themes, you are able to add whatever you like because of this code added to the `.wp-env.json` file: | ||
|
|
||
| ```json | ||
| "mappings": { | ||
| "wp-content/plugins": "./wp-core/plugins", | ||
| "wp-content/themes": "./wp-core/themes" | ||
| }, | ||
| ``` | ||
|
|
||
| In fact, after the initial setup, you may notice that in your code editor, there is now a `wp-core` folder containing the default plugins and themes, but it is grayed out, so the contents of this folder will not be committed to the GatherPress repository. | ||
|
|
||
|  | ||
|
|
||
| #### To shut down your development session | ||
|
|
||
| Simply run: | ||
|
|
||
| ```sh | ||
| wp-env stop | ||
| ``` | ||
|
|
||
| For more info on wp-env package, consult the [Block Handbook's page](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/). |