| 1 |
=== Code Snippets === |
| 2 |
Contributors: bungeshea, ver3, lightbulbman, 0aksmith, pauserratgutierrez, codesnippetspro |
| 3 |
Donate link: https://codesnippets.pro |
| 4 |
Tags: code, snippets, multisite, php, css |
| 5 |
License: GPL-2.0-or-later |
| 6 |
License URI: license.txt |
| 7 |
Stable tag: 3.6.6 |
| 8 |
Tested up to: 6.7.1 |
| 9 |
|
| 10 |
An easy, clean and simple way to enhance your site with code snippets. |
| 11 |
|
| 12 |
== Description == |
| 13 |
|
| 14 |
**✂ Code Snippets** provides an effortless way to enhance your WordPress site. |
| 15 |
|
| 16 |
**🚀 Upgrade to Code Snippets Pro** for complete CSS, JavaScript, Gutenberg, Elementor and cloud synchronisation integrations. **[Elevate your snippets experience now!](https://codesnippets.pro/pricing)** |
| 17 |
|
| 18 |
Say goodbye to the hassle of tweaking your theme's `functions.php` file and downloading endless plugins – Code Snippets simplifies the process! |
| 19 |
|
| 20 |
A snippet is like a mini-plugin for your WordPress site, providing added functionality without the clutter. |
| 21 |
|
| 22 |
Unlike other solutions that involve dumping code into your `functions.php` file, Code Snippets offers an intuitive graphical interface for seamless integration and real-time execution. Managing snippets is as easy as activating and deactivating plugins, only without the bloat and overhead. |
| 23 |
|
| 24 |
**🎥 Watch a quick overview by Imran Siddiq:** |
| 25 |
|
| 26 |
https://youtu.be/uzND-wdSCMQ |
| 27 |
|
| 28 |
☁️ Each copy of Code Snippets includes full integration with the community-powered [Code Snippets Cloud](https://codesnippets.cloud/) platform, providing easy access to hundreds of tweaks and enhancements ready to power-up any WordPress site. |
| 29 |
|
| 30 |
**🌐 Connect with us:** |
| 31 |
|
| 32 |
* [Support Forum](https://wordpress.org/support/plugin/code-snippets) |
| 33 |
* [Facebook Community](https://facebook.com/groups/codesnippetsplugin) |
| 34 |
* [GitHub Repository](https://github.com/codesnippetspro/code-snippets) |
| 35 |
|
| 36 |
🌟 Like our plugin? Find it useful? Please consider sharing your experience by [leaving a review on WordPress.org](https://wordpress.org/support/view/plugin-reviews/code-snippets). Your feedback is instrumental to shaping our future growth! |
| 37 |
|
| 38 |
🌍 We'd like to thank the wonderful people who have helped contribute translations to allow Code Snippets to be used in different languages. [You can find a full list here](https://github.com/codesnippetspro/code-snippets/blob/core/CREDITS.md#translators). |
| 39 |
|
| 40 |
== Installation == |
| 41 |
|
| 42 |
= Automatic installation = |
| 43 |
|
| 44 |
1. Log into your WordPress admin |
| 45 |
2. Click __Plugins__ |
| 46 |
|
| 47 |
3. Click __Add New__ |
| 48 |
|
| 49 |
4. Search for __Code Snippets__ |
| 50 |
|
| 51 |
5. Click __Install Now__ under "Code Snippets" |
| 52 |
6. Activate the plugin |
| 53 |
|
| 54 |
= Manual installation = |
| 55 |
|
| 56 |
1. Download the plugin |
| 57 |
2. Extract the contents of the zip file |
| 58 |
3. Upload the contents of the zip file to the `wp-content/plugins/` folder of your WordPress installation |
| 59 |
4. Activate the Code Snippets plugin from 'Plugins' page. |
| 60 |
|
| 61 |
Network Activating Code Snippets through the Network Dashboard will enable a special interface for running snippets across the entire network. |
| 62 |
|
| 63 |
== Frequently Asked Questions == |
| 64 |
|
| 65 |
A full list of our Frequently Asked Questions can be found at [help.codesnippets.pro](https://help.codesnippets.pro/collection/3-faq). |
| 66 |
|
| 67 |
= How can I recover my site if it is crashed by a buggy snippet? = |
| 68 |
You can recover your site by enabling the Code Snippets safe mode feature. Instructions for how to turn it on are available here: <https://help.codesnippets.pro/article/12-safe-mode>. |
| 69 |
|
| 70 |
= Will I lose my snippets if I change the theme or upgrade WordPress? = |
| 71 |
No, the snippets are stored in the WordPress database, independent of the theme and unaffected by WordPress upgrades. |
| 72 |
|
| 73 |
= Can the plugin be completely uninstalled? = |
| 74 |
If you enable the 'Complete Uninstall' option on the plugin settings page, Code Snippets will clean up all of its data when deleted through the WordPress 'Plugins' menu. This includes all stored snippets. If you would like to preserve the snippets, ensure they are exported first. |
| 75 |
|
| 76 |
= Can I copy snippets that I have created to another WordPress site? = |
| 77 |
Yes! You can individually export a single snippet using the link below the snippet name on the 'Manage Snippets' page or bulk export multiple snippets using the 'Bulk Actions' feature. Snippets can later be imported using the 'Import Snippets' page by uploading the export file. |
| 78 |
|
| 79 |
= Can I export my snippets to PHP for a site where I'm not using the Code Snippets plugin? = |
| 80 |
Yes. Click the checkboxes next to the snippets you want to export, and then choose **Export to PHP** from the Bulk Actions menu and click Apply. The generated PHP file will contain the exported snippets' code, as well as their name and description in comments. |
| 81 |
|
| 82 |
= Can I run network-wide snippets on a multisite installation? = |
| 83 |
You can run snippets across an entire multisite network by **Network Activating** Code Snippets through the Network Dashboard. You can also activate Code Snippets just on the main site, and then individually on other sites of your choice. |
| 84 |
|
| 85 |
= Where are the snippets stored in my WordPress database? = |
| 86 |
Snippets are stored in the `wp_snippets` table in the WordPress database. The table name may differ depending on what your table prefix is set to. |
| 87 |
|
| 88 |
= Where can I go for help or suggest new features? = |
| 89 |
You can get help with Code Snippets, report bugs or errors, and suggest new features and improvements either on the [WordPress Support Forums](https://wordpress.org/support/plugin/code-snippets) or on [GitHub](https://github.com/codesnippetspro/code-snippets). |
| 90 |
|
| 91 |
= How can I help contribute to the development of the Code Snippets plugin? = |
| 92 |
The best way to do this is to fork the [repository on GitHub](https://github.com/codesnippetspro/code-snippets) and send a pull request. |
| 93 |
|
| 94 |
= How can I report security bugs found in this plugin? = |
| 95 |
You can report security bugs found in the source code of this plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/code-snippets). The Patchstack team will assist with verification, triage, and notification of security vulnerabilities. |
| 96 |
|
| 97 |
== Screenshots == |
| 98 |
|
| 99 |
1. Managing existing snippets |
| 100 |
2. Adding a new snippet |
| 101 |
3. Editing a snippet |
| 102 |
4. Importing snippets from an export file |
| 103 |
|
| 104 |
== Changelog == |
| 105 |
|
| 106 |
= 3.6.6 (2024-11-27) = |
| 107 |
|
| 108 |
__Changed__ |
| 109 |
|
| 110 |
* Improved compatability with modern versions of PHP. |
| 111 |
* Extended welcome API to include admin notices. |
| 112 |
|
| 113 |
__Fixed__ |
| 114 |
|
| 115 |
* Memory issue from checking aggregate posts while loading front-end syntax highlighter. |
| 116 |
* Translation functions being called too early on upgrade, resulting in localisation loading errors. |
| 117 |
* Bug preventing the 'share on network' status of network snippets from correctly updating. |
| 118 |
* Incorrect logic controlling when to display 'Save Changes' or 'Save Changes and Activate' buttons. |
| 119 |
* Old notices persisting when switching between editing and creating snippets. |
| 120 |
|
| 121 |
= 3.6.5.1 (2024-05-24) = |
| 122 |
|
| 123 |
* Redeployment of [v3.6.5](#365-2024-05-24) to overcome issue with initial build. |
| 124 |
|
| 125 |
= 3.6.5 (2024-05-24) = |
| 126 |
|
| 127 |
__Added__ |
| 128 |
|
| 129 |
* New admin menu providing useful resources and updates on the Code Snippets plugin and community. |
| 130 |
|
| 131 |
= 3.6.4 (2024-03-15) = |
| 132 |
|
| 133 |
__Added__ |
| 134 |
|
| 135 |
* AI generation for all snippet types: HTML, CSS, JS. (PRO) |
| 136 |
* Button to create a cloud connection directly from the Snippets menu when disconnected. (PRO) |
| 137 |
|
| 138 |
__Changed__ |
| 139 |
|
| 140 |
* Increment the revision number of CSS and JS snippet when using the 'Reset Caches' debug action. (PRO) |
| 141 |
* UX in generate dialog, such as allowing 'Enter' to submit the form. (PRO) |
| 142 |
|
| 143 |
__Fixed__ |
| 144 |
|
| 145 |
* Minor type compatability issue with newer versions of PHP. |
| 146 |
* Undefined array key issue when initiating cloud sync. (PRO) |
| 147 |
* Bug preventing downloading a single snippet from a bundle. (PRO) |
| 148 |
* Translations not loading for strings in JavaScript files. |
| 149 |
|
| 150 |
= 3.6.3 (2023-11-13) = |
| 151 |
|
| 152 |
__Added__ |
| 153 |
|
| 154 |
* Added debug action for resetting snippets caches. |
| 155 |
|
| 156 |
__Fixed__ |
| 157 |
|
| 158 |
* Import error when initialising cloud sync configuration. (PRO) |
| 159 |
|
| 160 |
= 3.6.2 (2023-11-11) = |
| 161 |
|
| 162 |
__Removed__ |
| 163 |
|
| 164 |
* Removed automatic encoding of code content. |
| 165 |
|
| 166 |
__Fixed__ |
| 167 |
|
| 168 |
* Error when attempting to save shared network snippets marked as active. |
| 169 |
* Type error when rendering checkbox fields without a stored or default value. |
| 170 |
* Label for snippet sharing input incorrectly linked to input field. |
| 171 |
* Error when attempting to download export files from Edit menu. |
| 172 |
* Issue loading Freemius string overrides too early. (PRO) |
| 173 |
* Fix redirect URL when connecting with OAuth on subdirectory or HTTPS sites. (PRO) |
| 174 |
* Import error when attempting to completely uninstall the plugin. |
| 175 |
|
| 176 |
= 3.6.1 (2023-11-07) = |
| 177 |
|
| 178 |
__Fixed__ |
| 179 |
|
| 180 |
* Issue accessing fields on Snippets class. |
| 181 |
|
| 182 |
= 3.6.0 (2023-11-07) = |
| 183 |
|
| 184 |
__Added__ |
| 185 |
|
| 186 |
* Ability to authenticate with Code Snippets Cloud using OAuth. (PRO) |
| 187 |
* Integration with GPT AI for generating snippets. (PRO) |
| 188 |
* Ability to generate line-by-line descriptions of snippet code with GPT AI. (PRO) |
| 189 |
* Ability to generate tags and description text from existing snippet code with GPT AI. (PRO) |
| 190 |
* Added debug settings menu for manually performing problem-solving actions. |
| 191 |
* Filter to disable scroll-into-view functionality for edit page notices. |
| 192 |
|
| 193 |
__Changed__ |
| 194 |
|
| 195 |
* Updated minimum PHP requirement to 7.4. |
| 196 |
* Ensure that the URL of the edit snippet page changes when adding a new snippet. |
| 197 |
* Snippet tags will automatically be added when focus is lost on the tags field. |
| 198 |
|
| 199 |
__Fixed__ |
| 200 |
|
| 201 |
* Moved active status border on edit name field to left-hand side. |
| 202 |
* New notices will not scroll if already at top of page. |
| 203 |
* Potential CSRF vulnerability allowing an authenticated user to reset settings. |
| 204 |
|
| 205 |
= 3.5.1 (2023-09-15) = |
| 206 |
|
| 207 |
__Fixed__ |
| 208 |
|
| 209 |
* Undefined array key error when accessing plugin settings page. (PRO) |
| 210 |
* Issue registering API endpoints affecting edit post screen. (PRO) |
| 211 |
* Snippet ID instead of snippet object being passed to `code_snippets/update_snippet` action hook. |
| 212 |
|
| 213 |
= 3.5.0 (2023-09-13) = |
| 214 |
|
| 215 |
__Added__ |
| 216 |
|
| 217 |
* Support for the Code Snippets Cloud API. |
| 218 |
* Search and download public snippets. |
| 219 |
* Codevault back-up and synchronisation. (PRO) |
| 220 |
* Synchronised local snippets are automatically updated in Cloud. (PRO) |
| 221 |
* Bulk actions - 'update' and 'download'. |
| 222 |
* Download snippets from public and private codevaults. (PRO) |
| 223 |
* Search and download any publicly viewable snippet in Code Snippet Cloud by keyword or name of codevault. (PRO) |
| 224 |
* Deploy snippets to plugin from Code Snippets Cloud app. (PRO) |
| 225 |
* Bundles of Joy! Search and download Snippet Bundles in one go direct from Code Snippets Cloud. (PRO) |
| 226 |
|
| 227 |
__Changed__ |
| 228 |
|
| 229 |
* Redirect to snippets table when deleting snippet from the edit menu. |
| 230 |
* Scroll new notices into view on edit menu. |
| 231 |
|
| 232 |
__Fixed__ |
| 233 |
|
| 234 |
* Error when attempting to update network shared snippets after saving. [[#](https://wordpress.org/support/topic/activating-snippets-breaks-on-wordpress-6-3/)] |
| 235 |
|
| 236 |
= 3.4.2 (2023-07-05) = |
| 237 |
|
| 238 |
__Fixed__ |
| 239 |
|
| 240 |
* Issue causing export process to fail with fatal error. [[#](https://wordpress.org/support/topic/critical-error-on-exporting-snippets/)] |
| 241 |
* Type issue on `the_posts` filter when no posts available. [[#](https://wordpress.org/support/topic/collision-with-plugin-xml-sitemap-google-news/)] |
| 242 |
|
| 243 |
= 3.4.1 (2023-06-29) = |
| 244 |
|
| 245 |
__Added__ |
| 246 |
|
| 247 |
* Added better debugging when calling REST API methods from the edit menu. |
| 248 |
|
| 249 |
__Changed__ |
| 250 |
|
| 251 |
* Escape special characters when sending snippet code through AJAX to avoid false-positives from security modules. [[#](https://wordpress.org/support/topic/latest-3-4-0-ajax-bug-cannot-save-snippets-403-error/)] |
| 252 |
* Only display the latest update or error notice on the edit page, instead of allowing them to stack. |
| 253 |
|
| 254 |
__Fixed__ |
| 255 |
|
| 256 |
* Undefined array key error. [[#](https://wordpress.org/support/topic/after-updating-occasionally-getting-undefined-array-key-query/)] |
| 257 |
* Potential type issue when loading Prism. [[#](https://wordpress.org/support/topic/code-snippets-fatal-error-breaking-xml-sitemaps/)] |
| 258 |
* Potential type issue when sorting snippets. [[#](https://github.com/codesnippetspro/code-snippets/issues/166)] |
| 259 |
* Issue preventing asset revision numbers from updating correctly. (PRO) [[#](https://github.com/codesnippetspro/code-snippets/issues/166)] |
| 260 |
|
| 261 |
= 3.4.0 (2023-05-17) = |
| 262 |
|
| 263 |
__Added__ |
| 264 |
|
| 265 |
* Proper WordPress REST API support for retrieving and modifying snippets. |
| 266 |
* Added help links to content snippet options. |
| 267 |
|
| 268 |
__Changed__ |
| 269 |
|
| 270 |
* Better compatibility with modern versions of PHP (7.0+). |
| 271 |
* Converted Edit/Add New Snippet page to use React. |
| 272 |
* Converted action buttons to asynchronously use REST API endpoints through AJAX. |
| 273 |
* Load page components dynamically through React. |
| 274 |
* Added action notice queue system. |
| 275 |
* Replaced native alert dialog with proper React modal. |
| 276 |
* Catch snippet execution errors to prevent site from crashing. |
| 277 |
* Display recent snippet errors in admin dashboard instead. |
| 278 |
* Updated editor block to use new REST API endpoints. (PRO) |
| 279 |
* Change colour of upgrade notice in Pro plugin. (PRO) |
| 280 |
* All available snippet data is included in export files. |
| 281 |
* Only import specific fields from export file, even if additional fields specified. |
| 282 |
* Pass additional attributes specified in `[code_snippet]` content shortcode to shortcode content. |
| 283 |
* Make shortcode attributes available as individual variables. |
| 284 |
* Allow boolean attributes to be passed to code snippets shortcodes without specifying a value. |
| 285 |
* Replace external links to Pro pricing page with an upgrade modal. |
| 286 |
|
| 287 |
__Fixed__ |
| 288 |
|
| 289 |
* Issue preventing editor colorpicker from loading correctly. (PRO) |
| 290 |
* Issue preventing linting libraries from loading correctly in the code editor. |
| 291 |
|
| 292 |
= 3.3.0 (2023-03-09) = |
| 293 |
|
| 294 |
__Added__ |
| 295 |
|
| 296 |
* Added additional editor shortcuts to list in tooltip. |
| 297 |
* Filter for changing Snippets admin menu position. [See this help article for more information.](https://help.codesnippets.pro/article/61-how-can-i-change-the-location-of-the-snippets-admin-menu) |
| 298 |
* Ability to filter shortcode output. Thanks to contributions from [Jack Szwergold](https://github.com/JackSzwergold). |
| 299 |
|
| 300 |
__Fixed__ |
| 301 |
|
| 302 |
* Do not enqueue CSS or JS snippet file if no snippets exist. (PRO) |
| 303 |
* Bug causing all snippets to show in site health information instead of those active. |
| 304 |
* Unnecessary sanitization of file upload data causing import process to fail on Windows systems. |
| 305 |
|
| 306 |
= 3.2.2 (2022-11-17) = |
| 307 |
|
| 308 |
__Fixed__ |
| 309 |
|
| 310 |
* Plugin lacking a valid header error on activation. |
| 311 |
|
| 312 |
= 3.2.1 (2022-10-05) = |
| 313 |
|
| 314 |
__Added__ |
| 315 |
|
| 316 |
* `Ctrl`+`/` or `Cmd`+`/` as shortcut for commenting out code in the snippet editor. |
| 317 |
* Additional hooks to various snippet actions, thanks to contributions made by [ancient-spirit](https://github.com/ancient-spirit). |
| 318 |
* Fold markers, additional keyboard shortcuts and keymap options to snippet editor, |
| 319 |
thanks to contributions made by [Amaral Krichman](https://github.com/karmaral). |
| 320 |
* WP-CLI commands for retrieving, activating, deactivating, deleting, creating, updating, exporting and importing snippets. |
| 321 |
|
| 322 |
__Changed__ |
| 323 |
|
| 324 |
* Removed duplicate tables exist query. ([#](https://wordpress.org/support/topic/duplicate-queries-21)). |
| 325 |
* Enabled 'add paragraphs and formatting' option by default for newly inserted content snippets. |
| 326 |
|
| 327 |
__Fixed__ |
| 328 |
|
| 329 |
* Issue making survey reminder notice not dismissible. |
| 330 |
* Path to iron visible when updating the pro plugin. |
| 331 |
|
| 332 |
**[The full changelog is available on GitHub](https://github.com/codesnippetspro/code-snippets/blob/core/CHANGELOG.md)** |
| 333 |
|
