| 1 |
=== Snippet Shortcodes === |
| 2 |
Contributors: aliakro |
| 3 |
Tags: custom,shortcode,snippet,variable,library |
| 4 |
Requires at least: 6.0 |
| 5 |
Tested up to: 6.8 |
| 6 |
Stable tag: 5.0 |
| 7 |
Requires PHP: 7.4 |
| 8 |
License: GPLv2 or later |
| 9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 |
Donate link: https://www.paypal.me/yeken |
| 11 |
|
| 12 |
Create a library of custom shortcodes and reusable content, and seamlessly insert them into your posts and pages. |
| 13 |
|
| 14 |
== Description == |
| 15 |
|
| 16 |
> Create a library of custom shortcodes and reusable content, and seamlessly insert them into your posts and pages for streamlined, consistent site updates. Plus, get a head start with a built-in selection of ready-made shortcodes to use out of the box. |
| 17 |
|
| 18 |
Looking to reuse the same snippet of text or HTML across your website while only updating it in one spot? [Snippet Shortcodes](https://snippet-shortcodes.yeken.uk/) could be exactly what you need. With this tool, you can generate a library of custom shortcodes and embed them into your WordPress content. Using the familiar WordPress editor, you can insert anything from text and HTML to JavaScript, images, or any other elements supported by your theme or plugins. The biggest benefit? You only need to create the shortcode once, and you can then deploy it site-wide, saving time and ensuring consistency. |
| 19 |
|
| 20 |
*Quick example* |
| 21 |
|
| 22 |
By default, you tend to create content once and then copy and paste it across your site as needed. Later, when updates are required, you have to track down every instance, edit each one individually, and save every page or post - making consistent updates a tedious process. Instead, put a snippet like this into one of our [custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html) and get a shortcode you can paste into your content. To update, all you need to do is edit the [custom shortcode](https://snippet-shortcodes.yeken.uk/shortcodes-own.html) and your entire site will update consistently. |
| 23 |
|
| 24 |
``<a href="https://www.facebook.com/yekenuk" target="_blank" rel="noopener">Our Facebook</a> |
| 25 |
|
| 26 |
to |
| 27 |
|
| 28 |
``[sv slug="facebook-link"] |
| 29 |
|
| 30 |
**Basic Features** |
| 31 |
|
| 32 |
* **[Custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html)** – Create up to 10 custom shortcodes that can be embedded throughout your website. |
| 33 |
* **[Parameters](https://snippet-shortcodes.yeken.uk/shortcodes-own.html)** – Enhance your shortcodes by passing parameters into them e.g. [ sv slug="logo" color="blue" ] |
| 34 |
* **[Ready made shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-free.html)** – A collection of out-of-the-box shortcodes for displaying common WordPress fields such as site title, username, admin email, etc. |
| 35 |
* **HTML editor** – a HTML editor for editing your [custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html). |
| 36 |
|
| 37 |
**Premium Features** |
| 38 |
|
| 39 |
* **No limits** – create unlimited [custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html). |
| 40 |
* **Inline editor** – Ability to edit [custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html) quickly using the inline editor. |
| 41 |
* **Duplicator** – Ability to duplicate [custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html) with one button click. |
| 42 |
* **Enable/Disable** – Ability to enable or disable [custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html). |
| 43 |
* **Multi-site** – use [custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html) throughout your entire multi-site, not just limited to the one child site. |
| 44 |
* **[CSV import](https://snippet-shortcodes.yeken.uk/csv-import.html)** – Bulk import your custom shortcodes. |
| 45 |
* **[WooCommerce fields](https://snippet-shortcodes.yeken.uk/shortcodes/sc-woocommerce.html)** – A ready-made shortcode to display WooCommerce fields. |
| 46 |
* **[Fetch values from database](https://snippet-shortcodes.yeken.uk/shortcodes/sc-db-value-by-id.html)** – A ready-made shortcode to fetch a value from any database table. |
| 47 |
* An enhanced [collection of out-of-the-box shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-premium.html) for displaying additional WordPress fields, as well as wrapping around PHP functionality like GET/POST values, number of users, etc. |
| 48 |
|
| 49 |
==Pricing Plans== |
| 50 |
|
| 51 |
We're very transparent on our pricing and usually offer two plans: *yearly* and *lifetime*. For further information, please visit [our upgrade page](https://shop.yeken.uk/product/shortcode-variables/). |
| 52 |
|
| 53 |
== Getting support == |
| 54 |
|
| 55 |
If you have a question or an issue, please ask on the plugin's [WordPress support page](https://wordpress.org/support/plugin/shortcode-variables/), and we'll be more than happy to help. |
| 56 |
|
| 57 |
== Useful links == |
| 58 |
|
| 59 |
* [Snippet Shortcodes - Premium](https://snippetshortcodes.yeken.uk/) – main website for the Premium plugin. |
| 60 |
* [Snippet Shortcodes - Core](https://wordpress.org/plugins/shortcode-variables/) – WordPress.org page for the core plugin. |
| 61 |
* [Technical Documentation](https://snippet-shortcodes.yeken.uk/) – Installation and detailed documentation on how to use the plugin. |
| 62 |
* [Trial license](https://shop.yeken.uk/get-a-trial-license/) – Get a trial license to try out all the features. |
| 63 |
* [Upgrade](https://shop.yeken.uk/product/shortcode-variables/) – purchase a license to receive all of the features. |
| 64 |
|
| 65 |
== Screenshots == |
| 66 |
|
| 67 |
1. [Custom shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-own.html) list, with inline editor, duplicate, and delete options. |
| 68 |
2. Add a new [custom shortcode](https://snippet-shortcodes.yeken.uk/shortcodes-own.html). |
| 69 |
3. Edit an existing [custom shortcode](https://snippet-shortcodes.yeken.uk/shortcodes-own.html). |
| 70 |
4. Embeded the [custom shortcode](https://snippet-shortcodes.yeken.uk/shortcodes-own.html) into a page. |
| 71 |
5. A [custom shortcode](https://snippet-shortcodes.yeken.uk/shortcodes-own.html) rendered on a page. |
| 72 |
6. Admin page listing the [collection of out-of-the-box shortcodes](https://snippet-shortcodes.yeken.uk/shortcodes-premium.html) available. |
| 73 |
7. [CSV import](https://snippet-shortcodes.yeken.uk/csv-import.html) screen. |
| 74 |
|
| 75 |
== Upgrade Notice == |
| 76 |
|
| 77 |
5.0 - Premium features have been moved to a separate plugin (in accordance with WordPress rules). Please [download and activate Snippet Shortcodes – Premium](https://snippetshortcodes.yeken.uk/download/) |
| 78 |
|
| 79 |
== Changelog == |
| 80 |
|
| 81 |
= 5.0 = |
| 82 |
|
| 83 |
* New feature: A new HTML Editor when adding/editing your own shortcodes. |
| 84 |
* Change: Premium features have been moved to a separate plugin (in accordance with WordPress rules). Please [download and activate Snippet Shortcodes – Premium](https://snippetshortcodes.yeken.uk/download/) |
| 85 |
* Change: Simplified slugs for premade shortcodes by dropping the prefix "sc-" e.g. "sc-php-get-value" is now "php-get-value". |
| 86 |
* Improvement: Added "Copy to clipboard" button to the shortcode list page. |
| 87 |
* Improvement: Added new plugin icon to WP Admin Menu and WP Editor. |
| 88 |
* Improvement: Added tooltips to the admin interfaces (these can be disabled in settings). |
| 89 |
* Improvement: Plugin JS, CSS and other assets are only loaded on Shortcode Snippet admin pages (rather than any admin page). |
| 90 |
* Improvement: Updated Fontawesome library and moved from CDN to self hosted (e.g. dependencies are now included in the plugin). |
| 91 |
* Improvement: Various UI tweaks. |
| 92 |
* Improvement: Added various hooks. |
| 93 |
* Bug fix: Fixed an issue where button "Add" button was not resetting correctly after a failed attempt to add a shortcode. |
| 94 |
* Bug fix: Refreshing the shortcode list after saving a shortcode won't cause an error message to be displayed. |
| 95 |
|
| 96 |
= 4.2.5 = |
| 97 |
|
| 98 |
* Bug fix: In some instances, slug couldn't be specified when not a Premium user. |
| 99 |
|
| 100 |
= 4.2.4 = |
| 101 |
|
| 102 |
* Change: Updated Readme.txt. |
| 103 |
|
| 104 |
= 4.2.3 = |
| 105 |
|
| 106 |
* Improvement: All shortcodes are now editable even if there is no premium license. Previously only the top 10 shortcodes could be edited. |
| 107 |
* Improvement: Display update messages from Yeken.uk in Admin notices. |
| 108 |
* Change: Slugs can no longer be changed if not in Premium. |
| 109 |
* Bug fix: Fixed issues where save notifications etc appeared incorrectly within title boxes. |
| 110 |
|
| 111 |
= 4.2.2 = |
| 112 |
|
| 113 |
* Version bump for WP 6.8 compatibility. |
| 114 |
|
| 115 |
= 4.2 = |
| 116 |
|
| 117 |
* New feature: Added Premium shortcode for displaying WooComerce user fields. Read more: https://snippet-shortcodes.yeken.uk/shortcodes/sc-woocommerce |
| 118 |
* New feature: Added Premium shortcode for displaying WordPress meta fields. Read more: https://snippet-shortcodes.yeken.uk/shortcodes/sc-user-meta |
| 119 |
|
| 120 |
= 4.1.7 = |
| 121 |
|
| 122 |
* Improvement: Added additional security checks to Ajax handlers. |
| 123 |
|
| 124 |
= 4.1.6 = |
| 125 |
|
| 126 |
* New Feature: Extended [sv slug="sc-db-value-by-id"] shortcode to include the new argument "key-query-string". This allows a key to be read from the matching querystring value. Read more: https://snippet-shortcodes.yeken.uk/shortcodes/sc-db-value-by-id.html |
| 127 |
|
| 128 |
= 4.1.5 = |
| 129 |
|
| 130 |
* Maintenance: Added a nonce to the main admin Add/Edit UI screen. Although the form was on an admin screen and not exposed to the public, it doesn't hurt to add a nonce as well. Thanks Benedictus Jovan (aillesiM). |
| 131 |
|
| 132 |
= 4.1.4 = |
| 133 |
|
| 134 |
* Maintenance: Updated tested with WP 6.5 note. |
| 135 |
|
| 136 |
= 4.1.3 = |
| 137 |
|
| 138 |
* Bug fix: Fixed incorrect reference to ws_ls_to_bool() with sh_cd_to_bool() |
| 139 |
|
| 140 |
= 4.1.2 = |
| 141 |
|
| 142 |
* Improvement: By default, the shortcode [sv slug="sc-db-value-by-id"] shall be disabled unless explicitly enabled in WP Admin. |
| 143 |
* Improvement: Added the setting ''"sc-db-value-by-id" shortcode enabled?' to enable the shortcode [sv slug="sc-db-value-by-id"]. |
| 144 |
* Improvement: Added filter "disable-ss-sc-db-value-by-id" to hard disable the shortcode [sv slug="sc-db-value-by-id"]. |
| 145 |
|
| 146 |
= 4.1.1 = |
| 147 |
|
| 148 |
* Improvement: Dropped the database table prefix from the shortcode [sv slug="sc-db-value-by-id"] e.g. instead of specifying "users" table, it would now be "wp_users" (i.e. if a WP table, specify the prefix) |
| 149 |
|
| 150 |
= 4.1 = |
| 151 |
|
| 152 |
* New Feature: New Premium shortcode for fetching a value from a MySQL table, [sv slug="sc-db-value-by-id"]. Read more: https://snippet-shortcodes.yeken.uk/shortcodes/sc-db-value-by-id.html |
| 153 |
|
| 154 |
= 4.0.4 = |
| 155 |
|
| 156 |
* Bug fix: Added extra error handling around no multisite tags. |
| 157 |
|
| 158 |
= 4.0.3 = |
| 159 |
|
| 160 |
* Updated "Tested upto" statement. |
| 161 |
|
| 162 |
= 4.0.2 = |
| 163 |
|
| 164 |
* Tested up to version 6.0. |
| 165 |
|
| 166 |
= 4.0.1 = |
| 167 |
|
| 168 |
* Updated "Tested upto" WP version. |
| 169 |
|
| 170 |
= 4.0 = |
| 171 |
|
| 172 |
* New feature: Bulk import of shortcodes via CSV. |
| 173 |
* New feature: Quick Add shortcodes without having to open the editor and wait for page refreshes. |
| 174 |
* Improvement: Shortcodes can be deleted via Ajax on the list page. This saves waiting for a page refresh. |
| 175 |
* Improvement: Added "loading" animations on relevant UI elements. |
| 176 |
* Improvement: General code refactoring. |
| 177 |
* Bug fix: Allowed text in JS files to be correctly localised. |
| 178 |
|
| 179 |
= 3.5.4 = |
| 180 |
|
| 181 |
* Updated version WP compatibility statement. |
| 182 |
|
| 183 |
= 3.5.3 = |
| 184 |
|
| 185 |
* Updated version WP compatibility statement. |
| 186 |
|
| 187 |
= 3.5.2 = |
| 188 |
|
| 189 |
* Version bump. |
| 190 |
|
| 191 |
= 3.5.1 = |
| 192 |
|
| 193 |
* Bug fix: Corrected documentation and GitHub issue links. |
| 194 |
* Added a little text about emailing in suggestions. |
| 195 |
|
| 196 |
= 3.5 = |
| 197 |
|
| 198 |
* New Feature: New settings page. |
| 199 |
* New Feature: Allow authors and editors to view and edit your shortcodes. |
| 200 |
|
| 201 |
= 3.4.1 = |
| 202 |
|
| 203 |
* Bug fix: Fixed issue with saving. |
| 204 |
|
| 205 |
= 3.4 = |
| 206 |
|
| 207 |
* Improvement: Cosmetic tweaks to shortcode list table. |
| 208 |
* Bug fix: Fixed an issue where license price wasn't being displayed correctly. |
| 209 |
* Change: Updated links to new documentation website: https://snippet-shortcodes.yeken.uk/ |
| 210 |
* Change: Free users are now limited to 15 shortcodes. |
| 211 |
* Change: Tweaked Upgrade URL and default price. |
| 212 |
|
| 213 |
= 3.3.3 = |
| 214 |
|
| 215 |
* Updated "Tested upto" statement within readme.txt. |
| 216 |
|
| 217 |
= 3.3.2 = |
| 218 |
|
| 219 |
* Renamed plugin to Snippet Shortcodes! |
| 220 |
|
| 221 |
= 3.3.1 = |
| 222 |
|
| 223 |
* Updated tested upto version for 5.6 |
| 224 |
|
| 225 |
= 3.3 = |
| 226 |
|
| 227 |
* Improvement: Removed "Your shortcode has been saved" confirmation page. |
| 228 |
|
| 229 |
= 3.2.1 = |
| 230 |
|
| 231 |
* Readme tweaks. |
| 232 |
|
| 233 |
= 3.2 = |
| 234 |
|
| 235 |
* New Shortcode: "sc-user-profile-photo" – display the current user's profile photo. |
| 236 |
|
| 237 |
= 3.1.1 = |
| 238 |
|
| 239 |
* Updated compatibility version number. |
| 240 |
|
| 241 |
= 3.1 = |
| 242 |
|
| 243 |
* New Shortcode: "sc-site-current-url" – get the current URL. |
| 244 |
* New Shortcode: "sc-site-register-url" – get the URL for the WordPress registration page. |
| 245 |
* Improvement: Added localised strings so plugin can now be translated. |
| 246 |
* Improvement: Licenses are now checked daily and on each upgrade to ensure they are still valid. |
| 247 |
* Bug fix: Missing array element throwing error on shortcode listing page. |
| 248 |
* Bug fix: PHP warning being thrown on license page when one hasn't been added. |
| 249 |
* Bug fix: Always create multisite database table regardless. |
| 250 |
|
| 251 |
= 3.0.4 = |
| 252 |
|
| 253 |
* Improvement: Fetch license price from YeKen API |
| 254 |
|
| 255 |
= 3.0.3 = |
| 256 |
|
| 257 |
* Bug fix: Removed debug data altogether as causing unintended behaviour. |
| 258 |
|
| 259 |
= 3.0.2 = |
| 260 |
|
| 261 |
* Bug fix: Only display HTML caching comment on pages / posts. Currently rendering on things like AJAX responses and causing unintended behaviour. |
| 262 |
|
| 263 |
= 3.0.1 = |
| 264 |
|
| 265 |
* Bug fix: Fix error being thrown when not a multi site and DB table missing. |
| 266 |
|
| 267 |
= 3.0 = |
| 268 |
|
| 269 |
* Improvement: Support for multi-site variables. |
| 270 |
* Improvement: Replace shortcodes within menu titles. |
| 271 |
|
| 272 |
= 2.4.1 = |
| 273 |
|
| 274 |
* Bug fix: fixed save_result undeclared variable error. |
| 275 |
|
| 276 |
= 2.4 = |
| 277 |
|
| 278 |
* New Feature: Added a button to the WordPress text editor (classic mode) to allow users to easily insert shortcodes. |
| 279 |
* New Fetaure: Added a new shortcode sc-date. Allows you to do render today's date and add or subtract days, months and years. |
| 280 |
|
| 281 |
= 2.3 = |
| 282 |
|
| 283 |
* Improvement: sc-user-counts – Display a count of all WordPress users or the number of WordPress users for a given role e.g. [sv slug="sc-user-counts" role="subscriber"] or [sv slug="sc-user-counts"]. |
| 284 |
|
| 285 |
= 2.2.1 = |
| 286 |
|
| 287 |
* Bug fix: Fixed issue with clone. |
| 288 |
|
| 289 |
= 2.2 = |
| 290 |
|
| 291 |
* Improvement: Slugs can now be edited. |
| 292 |
|
| 293 |
= 2.1 = |
| 294 |
|
| 295 |
* New Feature: Added the ability to clone your own shortcodes. |
| 296 |
|
| 297 |
= 2.0.1 = |
| 298 |
|
| 299 |
* Bug fix: Fixed broken menu |
| 300 |
|
| 301 |
= 2.0 = |
| 302 |
|
| 303 |
* New Feature: Added additional premium shortcodes. |
| 304 |
* New Feature: Inline editing of shortcodes from the main list screen. |
| 305 |
* New Feature: Able to disable / enable shortcodes from shortcode list. |
| 306 |
* Improvement: Refactoring and optimisation of the entire plugin code. |
| 307 |
* Improvement: Added Fooicons. |
| 308 |
* Improvement: Added simple form validation when adding a record. |
| 309 |
|
| 310 |
= 1.8 = |
| 311 |
|
| 312 |
* Improvement: Added escaping for premade shortcodes. |
| 313 |
* Improvement: Added new shortcode "sc-privacy-url" for rendering Privacy URL link. |
| 314 |
|
| 315 |
= 1.7.4 = |
| 316 |
|
| 317 |
– Version and readme.txt updated to reflect 4.8 compatibility. |
| 318 |
|
| 319 |
= 1.7.3 = |
| 320 |
|
| 321 |
– BUG FIX: On the very first load of a variable it would return nothing. This was due to a bug in the code. The first load would display nothing to the user, however it would cache the shortcode correctly. Upon the next visit, the shortcode would render correctly! |
| 322 |
|
| 323 |
= 1.7.2 = |
| 324 |
|
| 325 |
– When creating a new shortcode, "Disabled" is set by default to "No". |
| 326 |
– Additional upgrade check added. This compares the previously stored version number against the new version number. If there is a difference, it will run the DB table check again. |
| 327 |
|
| 328 |
= 1.7.1 = |
| 329 |
|
| 330 |
– BUG FIX: Tweak made to "on activate" so the code required to change the relevant database tables is called correctly. |
| 331 |
|
| 332 |
= 1.7 = |
| 333 |
|
| 334 |
– Disable a variable. You can now disable a variable via the admin panel – if a shortcode is disabled nothing will be rendered in it's place (will remove the shortcode though). |
| 335 |
|
| 336 |
= 1.6.1 = |
| 337 |
|
| 338 |
– BUG FIX: Array declaration caused 500 error on non PHP 7 |
| 339 |
|
| 340 |
= 1.6 = |
| 341 |
|
| 342 |
– Now supports custom parameters. You can now add parameters when inserting a shortcode and specify where in the shortcode those parameters should appear. |
| 343 |
– BUG FIX: Removed a stray var_dump() |
| 344 |
|
| 345 |
= 1.5.1 = |
| 346 |
|
| 347 |
* BUG FIX: "Add new" link for message "You haven't created any shortcodes yet." wasn't working correctly |
| 348 |
* BUG FIX: Typo – "Shotcodes" instead of "Shortcodes" on "Your Shortcodes" page |
| 349 |
|
| 350 |
= 1.5 = |
| 351 |
|
| 352 |
* Added a shorter shortcode slug. So, instead of [shortcode-variables slug="your-slug-name"] you can also use [s-var slug="your-slug-name"] |
| 353 |
* BUG FIX: Some pre-made shortcodes weren't being rendered in the correct place. Fixed. |
| 354 |
|
| 355 |
= 1.4 = |
| 356 |
* Added the new pre-made shortcodes: |
| 357 |
* sc-login-page – Wordpress login page. Add the parameter "redirect" to specify where the user is taken after a successful login e.g. redirect="http://www.google.co.uk". |
| 358 |
* sc-username – Display the logged in username. |
| 359 |
* sc-user-id – Display the current user's ID |
| 360 |
* sc-user-ip – Display the current user's IP address. |
| 361 |
* sc-user-email – Display the current user's email address. |
| 362 |
* sc-username – Display the current user's username. |
| 363 |
* sc-first-name – Display the current user's first name. |
| 364 |
* sc-last-name – Display the current user's last name. |
| 365 |
* sc-display-name – Display the current user's display name. |
| 366 |
* sc-user-agent – Display the current user's user agent |
| 367 |
* BUG FIX: Deleting a shortcode from cache when deleted from Admin panel. This stops it getting rendered when removed from the plugin. |
| 368 |
|
| 369 |
= 1.3.1 = |
| 370 |
|
| 371 |
* Added some messages to encourage people to suggest premade tags. |
| 372 |
* Added version numbers. These are stored in DB to aid future upgrades. |
| 373 |
|
| 374 |
= 1.3 = |
| 375 |
|
| 376 |
This was a dummy release to fix an SVN issue with the 1.2 release! |
| 377 |
|
| 378 |
= 1.2 = |
| 379 |
|
| 380 |
* Added Premade shortcodes and framework to add additional ones |
| 381 |
* Added Top Level menu item to support two sub pages. One for user defined shortcodes and another for premade shortcodes. |
| 382 |
|
| 383 |
= 1.1 = |
| 384 |
* Added caching to SQL queries. Therefore making shortcode rendering faster and reduce load on mySQL. |
| 385 |
* TinyMCE editor for editing shortcode content. |
| 386 |
* You can now specify other shortcodes within your Snippet Shortcodes. |
| 387 |
* Readme.txt fixes |
| 388 |
|
| 389 |
= 1.0 = |
| 390 |
* Initial Release |
| 391 |
|
