-
-
Notifications
You must be signed in to change notification settings - Fork 14
/
README.txt
234 lines (154 loc) · 7.64 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
=== utm.codes ===
Contributors: chrislarrycarl
Donate link: https://utm.codes/pricing/
Tags: analytics, utm codes, analytics, google analytics, campaign marketing, link generator
Requires at least: 5.1.0
Tested up to: 6.5
Requires PHP: 7.1.0
Stable tag: 1.8.5
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html
A WordPress plugin that makes building analytics friendly links quick and easy.
== Description ==
It's time to ditch the spreadsheets for a better way to create and manage your campaign marketing links.
utm.codes turns your WordPress admin into a link building powerhouse by making it easier to create, organize, and use your links.
For more information, videos, and helpful tips [visit the utm.codes website](https://utm.codes).
= Features =
- Easily create campaign marketing links with UTM codes for better campaign analytics
- Automatically format links in lowercase, remove spaces, and remove non alphanumeric characters for more consistent reporting
- Batch create links for all your social networks with just a click
- Search, filter, and easily find existing links using familiar WordPress admin controls
- Automatically detect url error responses to prevent creating bad links
- One click link shortening with Bitly or Rebrandly for easier link sharing
- Save notes with link for team communication, usage context, future reference, and more
- Link element API filter for custom utm code formatting
- Social network options API filter for custom batch link options
- Shortener API filter for custom link shortening
- Supports adding additional custom parameters to links for improved versatility
- Multi-user access within WordPress to share creation and management responsibilities
- See your current link count in the admin dashboard "At a Glance"
- Tested with WordPress 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 5.9, 6.0, 6.1, 6.2, 6.3, 6.4, 6.5
- Tested with PHP 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3
- Tested with MySQL 5.6, 5.7, 8.0
- 100% Free and Open Source
= Installation =
Upload the utm.codes plugin to your WordPress site, activate it, and start creating your links.
= Settings =
Configure your formatting preferences, targeted social networks, link notes, and shortening preferences, under Settings / utm.codes to enable batch creation and shorten when saving links.
= Documentation =
For additional details about installing, configuring, customizing, and using utm.codes [visit our GitHub wiki](https://github.com/asdfdotdev/utm.codes/wiki)
= Development Resources =
utm.codes is built using development code not included in the WordPress.org download because it isn't required for use. This code includes the webpack build used to create our minified CSS and JavaScript as well as PHPUnit tests to ensure support of new WordPress releases.
All source code associated with utm.codes is open source, free to use for any purpose, and released under the GPL v2.0 license. Development code, including instructions for running both the build and tests, is available at the [utm.codes GitHub repository](https://github.com/asdfdotdev/utm.codes).
You can also [browse our build history at GitHub](https://github.com/asdfdotdev/utm.codes/actions).
== Frequently Asked Questions ==
= Why is the shorten link checkbox missing when I create a link? =
Shortening links requires a shortener be configured. Configure shortening under Settings > utm.codes.
= Why is the create social links checkbox missing when I create a link? =
Batch social link creation requires selection of social networks. Select networks under Settings > utm.codes to create links for your preferred networks when batch creating social links.
= What if I need custom parameters in my links? =
Simply add the parameter to your Link URL (e.g. https://example.com/?param=value) and utm.codes will append the generated utm code values to the end of the url when you save the link.
= What if I need custom parameter formats? =
Adding your own custom formatting is easy with an API filter. Visit our GitHub wiki for examples and more details.
= What if I want to share links on a social network your settings don't support? =
Adding your own custom social network options is easy with an API filter. Visit our GitHub wiki for examples and more details.
= What if I want to shorten my links using a service other than Bitly or Rebrandly? =
Adding your own shortener support is easy with a custom shortener class and API filter. Visit our GitHub wiki for examples and more details.
= I love this plugin. =
That isn't a question. But thank you.
== Screenshots ==
1. The links list provides easy access to search, filter, edit, and copy links
2. Shorten links just by clicking the checkbox
3. Create social links in batch just by clicking the checkbox
4. Configure settings for link format, labels, link notes, your favorite social networks, and shortener
5. See your link count in the WordPress dashboard "At a Glance"
== Changelog ==
= 1.8.5 =
- Supports WordPress v6.3, v6.4, v6.5
- Update dependencies
= 1.8.4 =
- Supports WordPress v6.2
- Update dependencies
- Update minimum requirements
= 1.8.3 =
- Supports WordPress v6.1
- Supports PHP 8.2
- Update dependencies
= 1.8.2 =
- Supports WordPress v6.0
- Update dependencies
= 1.8.1 =
- Fix marketing links post list filters
= 1.8.0 =
- Supports WordPress v5.9
- Update dependencies
- New PHP 8 support, tests
= 1.7.6 =
- Supports WordPress v5.8
- Update dependencies
= 1.7.5 =
- Supports WordPress v5.7
- Adds important fix for rebrandly custom domain API response sanitation
- Update dependencies
= 1.7.4 =
- Supports WordPress v5.6
- Migrate from Travis-CI to GitHub Actions
- Update dependencies
= 1.7.3 =
- Supports WordPress v5.5.3
- Changes webpack build
- Update dependencies
= 1.7.2 =
- Supports WordPress v5.5
- Update dependencies
= 1.7.1 =
- Cleanup permissions
- Update dependencies
- Increment tested up to to v5.4.2
= 1.7.0 =
- Supports WordPress v5.4
- New use your custom domain when shortening with Rebrandly
= 1.6.3 =
This release doesn't add new functionality, however, it does add a bit of needed housekeeping and increments tested up to for WordPress v5.3
= 1.6.2 =
- Fix quick edit post link hide bug
- Switch tools to WP-CLI for language file generation
= 1.6.1 =
- Fix bug with custom shortener API
= 1.6.0 =
- Change Bitly API from v3 to v4
- New Rebrandly API Support for link shortening
- New API filter for custom shortener service support (See Wiki for details)
- New API filter for custom error messages (custom shortener user feedback)
- New unit tests for Bitly and Rebrandly
- New mock shortener for integration tests
- Documentation Updates
= 1.5.0 =
- New API filter for custom social network options (examples in the wiki)
- New unit tests
- Code quality updates
- Changes Publish button text to Save, remove quick edit (GitHub Issue #28)
= 1.4.0 =
- New API filter for custom link element formats (examples in the wiki)
- New Notes field - save notes with your links for contextual reference
- New link to Bitly report in links list for shortened links
- Additional Code Standards Improvements
- Fix link labels for batch social links to support security release changes
= 1.3.1 =
This release does not add new functionality, however, it does meaningfully improve utm.codes adherence to WordPress coding standards and improves the overall quality of the plugin.
= 1.3.0 =
- Supports WordPress 5.0
- Fix filter label
- Replace gulp build with webpack
- Improved test coverage
= 1.2.0 =
- Replace Goo.gl with Bitly url shortener
- New "Labels" taxonomy
- New link tester
= 1.1.0 =
- New link formatting options
- New Logo
= 1.0.1 =
Fixes bug in batch link creation where source/medium were omitted from first generated link.
= 1.0.0 =
Initial release