Skip to content

Commit 94c0326

Browse files
authored
update readme (#27)
1 parent a5d8894 commit 94c0326

File tree

2 files changed

+90
-84
lines changed

2 files changed

+90
-84
lines changed

README.md

Lines changed: 31 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ Gravity Forms CLI Add-On
33

44
The Gravity Forms CLI Add-On allows WP-CLI users to manage installation, forms and entries on the command line.
55

6+
[Documentation](https://docs.gravityforms.com/category/add-ons-gravity-forms/wp-cli-add-on/)
7+
68
Video demos:
79

810
[Form Management](https://www.youtube.com/watch?v=LO3fLW6SWk0])
@@ -12,17 +14,17 @@ Video demos:
1214
Getting started
1315
---------------
1416

15-
* wp help gf
16-
* wp help gf form
17-
* wp help gf field
18-
* wp help gf entry
19-
* wp gf license
20-
* wp help gf tool
17+
* `wp help gf`
18+
* `wp help gf form`
19+
* `wp help gf field`
20+
* `wp help gf entry`
21+
* `wp gf license`
22+
* `wp help gf tool`
2123

2224
Form Management
2325
---------------
2426

25-
wp gf form [command]
27+
`wp gf form [command]`
2628

2729
Commands:
2830

@@ -39,8 +41,8 @@ Commands:
3941
Field Management
4042
----------------
4143

42-
* wp gf form field [command]
43-
* wp gf field [command] (alias)
44+
* `wp gf form field [command]`
45+
* `wp gf field [command]` (alias)
4446

4547
Commands:
4648

@@ -55,8 +57,8 @@ Commands:
5557
Notification Management
5658
-----------------------
5759

58-
* wp gf form notification [command]
59-
* wp gf notification [command] (alias)
60+
* `wp gf form notification [command]`
61+
* `wp gf notification [command]` (alias)
6062

6163
Commands:
6264

@@ -71,7 +73,7 @@ Commands:
7173
Entry Management
7274
----------------
7375

74-
wp gf entry [command]
76+
`wp gf entry [command]`
7577

7678
Commands:
7779

@@ -88,7 +90,7 @@ Commands:
8890
Entry Notifications
8991
-------------------
9092

91-
wp gf entry notification [command]
93+
`wp gf entry notification [command]`
9294

9395
Commands:
9496

@@ -98,7 +100,7 @@ Commands:
98100
License Management
99101
-------------------
100102

101-
wp gf license [command]
103+
`wp gf license [command]`
102104

103105
Commands:
104106

@@ -109,7 +111,7 @@ Commands:
109111
Misc Tools
110112
----------
111113

112-
wp gf tool [command]
114+
`wp gf tool [command]`
113115

114116
Commands:
115117

@@ -125,35 +127,35 @@ The above commands all require Gravity Forms to be installed. However, if Gravit
125127

126128
The install command will download and install the latest version Gravity Forms and then run the database setup. The license key will be saved in the plugin settings.
127129

128-
A valid license key is required either in the GF_LICENSE_KEY constant or the --key option.
130+
A valid license key is required either in the `GF_LICENSE_KEY` constant or the `--key` option.
129131

130132
Examples:
131133

132-
* wp gf install -key=xxxxx
133-
* wp gf install -key=xxxxx --activate
134-
* wp gf install gravityformspolls -key=xxxxx
135-
* wp gf install gravityformsquiz -key=xxxxx
134+
* `wp gf install --key=xxxxx`
135+
* `wp gf install --key=xxxxx --activate`
136+
* `wp gf install gravityformspolls --key=xxxxx`
137+
* `wp gf install gravityformsquiz --key=xxxxx`
136138

137-
Once installed, the database can be set up or upgraded separately using the setup command. The command will not re-run the setup unless the --force flag is set.
139+
Once installed, the database can be set up or upgraded separately using the setup command. The command will not re-run the setup unless the `--force` flag is set.
138140

139141
Examples:
140142

141-
* wp gf setup
142-
* wp gf setup --force
143+
* `wp gf setup`
144+
* `wp gf setup --force`
143145

144146
Gravity Forms and add-ons can be updated using the update command.
145147

146148
Examples:
147149

148-
* wp gf update
149-
* wp gf update gravityformspolls
150+
* `wp gf update`
151+
* `wp gf update gravityformspolls`
150152

151153
Check the current version using the version command.
152154

153155
Examples:
154156

155-
* wp gf version
156-
* wp gf version gravityformspolls
157+
* `wp gf version`
158+
* `wp gf version gravityformspolls`
157159

158160

159161
Requirements
@@ -167,6 +169,6 @@ Requirements
167169
Support
168170
-------
169171

170-
If you find anything that needs fixing, or if you have any ideas for improvements, please open a support ticket:
171-
https://www.gravityforms.com/open-support-ticket/
172+
If you find anything that needs fixing please open a support ticket at https://www.gravityforms.com/open-support-ticket/
172173

174+
If you have any ideas for improvements please submit your idea at https://www.gravityforms.com/gravity-forms-roadmap/

readme.txt

Lines changed: 59 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,8 @@ Manage Gravity Forms on the command line.
1313

1414
The Gravity Forms CLI Add-On allows WP-CLI users to manage forms and entries and more on the command line.
1515

16+
[Documentation](https://docs.gravityforms.com/category/add-ons-gravity-forms/wp-cli-add-on/)
17+
1618
Form Management
1719
[youtube https://www.youtube.com/watch?v=LO3fLW6SWk0]
1820

@@ -21,20 +23,20 @@ Entry Management
2123

2224
= Getting started =
2325

24-
* wp help gf
25-
* wp help gf form
26-
* wp help gf form field
27-
* wp help gf form notification
28-
* wp help gf entry
29-
* wp help gf entry notification
30-
* wp help gf install
31-
* wp help gf setup
32-
* wp help gf license
33-
* wp help gf tool
26+
* `wp help gf`
27+
* `wp help gf form`
28+
* `wp help gf form field`
29+
* `wp help gf form notification`
30+
* `wp help gf entry`
31+
* `wp help gf entry notification`
32+
* `wp help gf install`
33+
* `wp help gf setup`
34+
* `wp help gf license`
35+
* `wp help gf tool`
3436

3537
= Form Management =
3638

37-
wp gf form [command]
39+
`wp gf form [command]`
3840

3941
Commands:
4042

@@ -50,8 +52,8 @@ Commands:
5052

5153
= Field Management =
5254

53-
* wp gf form field [command]
54-
* wp gf field [command] (alias)
55+
* `wp gf form field [command]`
56+
* `wp gf field [command]` (alias)
5557

5658
Commands:
5759

@@ -65,8 +67,8 @@ Commands:
6567

6668
= Notification Management =
6769

68-
* wp gf form notification [command]
69-
* wp gf notification [command] (alias)
70+
* `wp gf form notification [command]`
71+
* `wp gf notification [command]` (alias)
7072

7173
Commands:
7274

@@ -80,7 +82,7 @@ Commands:
8082

8183
= Entry Management =
8284

83-
wp gf entry [command]
85+
`wp gf entry [command]`
8486

8587
Commands:
8688

@@ -96,7 +98,7 @@ Commands:
9698

9799
= Entry Notifications =
98100

99-
wp gf entry notification [command]
101+
`wp gf entry notification [command]`
100102

101103
Commands:
102104

@@ -105,7 +107,7 @@ Commands:
105107

106108
= License Management =
107109

108-
wp gf license [command]
110+
`wp gf license [command]`
109111

110112
Commands:
111113

@@ -114,7 +116,7 @@ Commands:
114116

115117
= Misc Tools =
116118

117-
wp gf tool [command]
119+
`wp gf tool [command]`
118120

119121
Commands:
120122

@@ -129,36 +131,36 @@ The above commands all require Gravity Forms to be installed. However, if Gravit
129131

130132
The install command will download and install the latest version Gravity Forms available for auto-update and then run the database setup. The license key will be saved in the plugin settings.
131133

132-
A valid license key is required either in the GF_LICENSE_KEY constant or the --key option.
134+
A valid license key is required either in the `GF_LICENSE_KEY` constant or the `--key` option.
133135

134136
Examples:
135137

136-
* wp gf install -key=xxxxx
137-
* wp gf install -key=xxxxx --activate
138-
* wp gf install gravityformspolls -key=xxxxx
139-
* wp gf install gravityformsquiz -key=xxxxx
138+
* `wp gf install --key=xxxxx`
139+
* `wp gf install --key=xxxxx --activate`
140+
* `wp gf install gravityformspolls --key=xxxxx`
141+
* `wp gf install gravityformsquiz --key=xxxxx`
140142

141-
Once installed, the database can be set up or upgraded separately using the setup command. The command will not re-run the setup unless the --force flag is set.
143+
Once installed, the database can be set up or upgraded separately using the setup command. The command will not re-run the setup unless the `--force` flag is set.
142144

143145
Examples:
144146

145-
* wp gf setup
146-
* wp gf setup --force
147+
* `wp gf setup`
148+
* `wp gf setup --force`
147149

148150
Gravity Forms and official add-ons can be updated using the update command.
149151

150152
Examples:
151153

152-
* wp gf update
153-
* wp gf update gravityformspolls
154+
* `wp gf update`
155+
* `wp gf update gravityformspolls`
154156

155157

156158
Check the current version using the version command.
157159

158160
Examples:
159161

160-
* wp gf version
161-
* wp gf version gravityformspolls
162+
* `wp gf version`
163+
* `wp gf version gravityformspolls`
162164

163165

164166
= Requirements =
@@ -169,12 +171,14 @@ Examples:
169171

170172
= Support =
171173

172-
If you find any that needs fixing, or if you have any ideas for improvements, please submit a support ticket:
173-
https://www.gravityforms.com/open-support-ticket/
174+
If you find anything that needs fixing please open a support ticket at https://www.gravityforms.com/open-support-ticket/
174175

176+
If you have any ideas for improvements please submit your idea at https://www.gravityforms.com/gravity-forms-roadmap/
175177

176178
== Installation ==
177179

180+
`wp plugin install gravityformscli --activate` or
181+
178182
1. Download the zipped file.
179183
1. Extract and upload the contents of the folder to /wp-contents/plugins/ folder
180184
1. Go to the Plugin management page of WordPress admin section and enable the 'Gravity Forms CLI' plugin
@@ -183,44 +187,44 @@ https://www.gravityforms.com/open-support-ticket/
183187

184188
= 1.2 =
185189
- Updated Gravity API domain.
186-
- Updated the ids format of the entry list command to support the page-size and offset args. Credit: Ulrich Pogson.
187-
- Updated the form export command to support the optional filename arg e.g. wp gf form export 1 --filename=testing.json. Credit: Timothy Decker.
188-
- Fixed an issue where the install command could not network activate plugins.
189-
- Fixed an error occurring when using the form notification update command without the notification-id arg.
190-
- Fixed an issue with the entry export command.
190+
- Updated the ids format of the `wp gf entry list` command to support the page-size and offset args. Credit: Ulrich Pogson.
191+
- Updated the form export command to support the optional filename arg e.g. `wp gf form export 1 --filename=testing.json`. Credit: Timothy Decker.
192+
- Fixed an issue where the `wp gf install` command could not network activate plugins.
193+
- Fixed an error occurring when using the `wp gf form notification update` command without the notification-id arg.
194+
- Fixed an issue with the `wp gf entry export` command.
191195

192196
= 1.1 =
193-
- Added support for start_date and end_date filters for the entry export command. e.g. wp gf entry export 11 --start_date="2018-11-01" --end_date="2018-11-11"
194-
- Added the "wp gf tool system-report" command and the "wp gf tool status" alias for outputting the system report from the Gravity Forms 2.2+ System Status page.
195-
- Fixed an issue with the "wp gf install" command ending with an error message when no error occurred.
197+
- Added support for start_date and end_date filters for the entry export command. e.g. `wp gf entry export 11 --start_date="2018-11-01" --end_date="2018-11-11"`
198+
- Added the `wp gf tool system-report` command and the `wp gf tool status` alias for outputting the system report from the Gravity Forms 2.2+ System Status page.
199+
- Fixed an issue with the `wp gf install` command ending with an error message when no error occurred.
196200
- Fixed an issue where old messages could continue to be displayed in the admin following a license key change.
197-
- Fixed an "invalid synopsis part" warning and an "unknown parameter" error with the wp gf form field update command.
198-
- Fixed the wp gf form update command using the wrong argument to get the existing form which could result in a form not found error.
199-
- Fixed an issue with the form create command where missing field IDs are added automatically.
201+
- Fixed an "invalid synopsis part" warning and an "unknown parameter" error with the `wp gf form field update` command.
202+
- Fixed the `wp gf form update` command using the wrong argument to get the existing form which could result in a form not found error.
203+
- Fixed an issue with the `wp gf form create` command where missing field IDs are added automatically.
200204

201205
= 1.0 =
202-
- Added the wp gf license command.
206+
- Added the `wp gf license` command.
203207
- Fixed an issue with updating forms from an export file.
204208

205209
= 1.0-rc-1 =
206-
- Added the --file arg to the wp gf form update command to allow forms to be updated from an export file.
210+
- Added the `--file` arg to the `wp gf form update` command to allow forms to be updated from an export file.
207211
- Fixed a fatal error when using the install command.
208212

209213
= 1.0-beta-5 =
210-
- Added the wp gf form notification command.
211-
- Added the wp gf entry notification command.
212-
- Added the wp version command.
213-
- Added the wp update command.
214-
- Updated the install and update commands to download the latest hotfix version by default.
215-
- Fixed an issue with wp gf form export <form-id> where the form ID is ignored.
214+
- Added the `wp gf form notification` command.
215+
- Added the `wp gf entry notification` command.
216+
- Added the `wp gf version` command.
217+
- Added the `wp gf update` command.
218+
- Updated the `install` and `update` commands to download the latest hotfix version by default.
219+
- Fixed an issue with `wp gf form export <form-id>` where the form ID is ignored.
216220

217221
= 1.0-beta-4 =
218-
- Updated the install command to pass the --force value to the setup command.
222+
- Updated the `install` command to pass the `--force` value to the setup command.
219223
- Updated the output when forcing the setup.
220224

221225
= 1.0-beta-3 =
222-
- Added the wp gf setup command
223-
- Fixed an issue with the install command where the database was not setup until visiting the WP dashboard.
226+
- Added the `wp gf setup` command
227+
- Fixed an issue with the `install` command where the database was not setup until visiting the WP dashboard.
224228
- Updated the WP-CLI requirement to 1.0+
225229

226230
= 1.0-beta-2 =

0 commit comments

Comments
 (0)