| 1 |
=== Code Snippets === |
| 2 |
Contributors: bungeshea, ver3 |
| 3 |
Donate link: https://codesnippets.pro |
| 4 |
Tags: snippets, functions, multisite, code, php, html, css, javascript |
| 5 |
License: MIT |
| 6 |
License URI: license.txt |
| 7 |
Stable tag: 3.2.1 |
| 8 |
Tested up to: 6.0.1 |
| 9 |
|
| 10 |
An easy, clean and simple way to run code snippets on your site. |
| 11 |
|
| 12 |
== Description == |
| 13 |
|
| 14 |
Code Snippets is an easy, clean and simple way to run code snippets on your site. It removes the need to add custom snippets to your theme's `functions.php` file. |
| 15 |
|
| 16 |
[**Code Snippets Pro** is now available, with full CSS, JavaScript, Gutenberg and Elementor integrations.](https://codesnippets.pro/pricing/) |
| 17 |
|
| 18 |
A snippet is a small chunk of PHP code that you can use to extend the functionality of a WordPress-powered website; essentially a mini-plugin with less load on your site. |
| 19 |
|
| 20 |
Most snippet-hosting sites tell you to add snippet code to your active theme's `functions.php` file, which can get rather long and messy after a while. |
| 21 |
|
| 22 |
Code Snippets changes that by providing a GUI interface for adding snippets and **actually running them on your site** just as if they were in your theme's `functions.php` file. |
| 23 |
|
| 24 |
**Quick overview of Code Snippets by Imran Siddiq** |
| 25 |
|
| 26 |
https://youtu.be/EMjIWjcYONk |
| 27 |
|
| 28 |
Code Snippets provides graphical interface, similar to the Plugins menu, for managing snippets. Snippets can be activated and deactivated, just like plugins. |
| 29 |
|
| 30 |
The snippet editor includes fields for a name, a visual editor-enabled description, tags to allow you to categorize snippets, and a full-featured code editor. Snippets can be exported for transfer to another site, either in JSON for later importing by the Code Snippets plugin, or in PHP for creating your own plugin or theme. |
| 31 |
|
| 32 |
**Comprehensive Code Snippets tutorial with practical examples by Ferdy Korpershoek** |
| 33 |
|
| 34 |
https://youtu.be/29jD2BcBX5w |
| 35 |
|
| 36 |
If you have any feedback, issues, or suggestions for improvements please leave a topic in the [Support Forum](https://wordpress.org/support/plugin/code-snippets), [join the community on Facebook](https://facebook.com/groups/codesnippetsplugin), or [check us out on GitHub](https://github.com/sheabunge/code-snippets). |
| 37 |
|
| 38 |
If you like this plugin, or it is useful to you in some way, please consider reviewing it on [WordPress.org](https://wordpress.org/support/view/plugin-reviews/code-snippets). |
| 39 |
|
| 40 |
== Translations == |
| 41 |
|
| 42 |
Code Snippets can be used in these different languages thanks to the following translators: |
| 43 |
|
| 44 |
* Belarusian – [Hrank.com](https://www.hrank.com) |
| 45 |
* Brazilian Portuguese – [Bruno Borges](http://brunoborges.info) |
| 46 |
* Chinese – [Jincheng Shan](http://shanjincheng.com) and [诗语](https://profiles.wordpress.org/f2010525/) |
| 47 |
* Chinese (Taiwan) – [Alex Lion](https://www.alexclassroom.com/) and [Chun-Chih Cheng](https://profiles.wordpress.org/alex1114/) |
| 48 |
* Croatian – [Borisa Djuraskovic from Web Hosting Hub](https://www.webhostinghub.com/) |
| 49 |
* Czech – [Lukáš Tesař](mailto:lukastesar03@gmail.com) and [Jakub Humpolec](https://profiles.wordpress.org/jumphy/) |
| 50 |
* Danish – [Finn Sommer Jensen](https://profiles.wordpress.org/finnsommer/) |
| 51 |
* Dutch – [Sander Spies](https://github.com/sander1), [Peter Smits](https://psmits.com) and [mother.of.code.a11n](https://profiles.wordpress.org/imazed/) |
| 52 |
* English (New Zealand) and English (UK) – [webaware](https://profiles.wordpress.org/webaware/) |
| 53 |
* English (South Africa) – [webaware](https://profiles.wordpress.org/webaware/) and [Ian Barnes](https://profiles.wordpress.org/ianbarnes/) |
| 54 |
* French – [momo-fr](https://www.momofr.net/), [Didier Demory](https://www.wptrads.com/), [Cyrille Sanson](https://100son.net/) and [Shea Bunge](https://sheabunge.com) |
| 55 |
* French (Canada) – [Dominic Desbiens](https://www.dominicdesbiens.com/) |
| 56 |
* German – [Mario Siegmann](https://web-alltag.de/), [Joerg Knoerchen](https://www.sensorgrafie.de/), [David Decker](https://deckerweb.de) and [Andreas](https://profiles.wordpress.org/perryzelda/) |
| 57 |
* Greek – [Konstantinos Megas](https://profiles.wordpress.org/nextdoorpanda/) and [Toni Bishop from Jrop](https://www.jrop.com/) |
| 58 |
* Indonesian – [Jordan Silaen from ChameleonJohn.com](https://www.chameleonjohn.com/) |
| 59 |
* Italian – [Usman Wagan](https://coupontoaster.com/), [Luisa Ravelli](https://profiles.wordpress.org/darkavenger/) and [ElectricFeet](https://profiles.wordpress.org/electricfeet/) |
| 60 |
* Japanese – [mt8](https://mt8.biz/), [Takakazu Nagaya](https://profiles.wordpress.org/tanagaya/), [Naoko Takano](https://naoko.blog/) and [melvas](https://profiles.wordpress.org/melvas/) |
| 61 |
* Persian – [Mohammad Novintanon](http://mnovintan.ir/) |
| 62 |
* Russian – [Alexander Samsonov](http://www.wordpressplugins.ru/administration/code-snippets.html), [Yui](https://profiles.wordpress.org/fierevere/), [Denis Yanchevskiy](https://denisco.pro/) and [krioteh](https://profiles.wordpress.org/krioteh/) |
| 63 |
* Slovak – [Ján Fajčák](https://wp.sk) |
| 64 |
* Spanish (Colombia) and Spanish (Ecuador) – [Javier Esteban](https://javieresteban.org/) |
| 65 |
* Spanish (Spain) – [Ibidem Group](https://www.ibidemgroup.com), [Javier Esteban](https://javieresteban.org/), [Fernando Tellado](https://ayudawp.com/) and [Juanma Aranda](https://juanmaaranda.com/) |
| 66 |
* Spanish (Venezuela) – [Yordan Soares](https://yordansoar.es/) |
| 67 |
* Swedish – [Argentum](https://profiles.wordpress.org/argentum/), [Fredrik](https://profiles.wordpress.org/elbogen/) and [Tor-Bjorn Fjellner](https://profiles.wordpress.org/tobifjellner/) |
| 68 |
* Urdu – [Samuel Badree](https://mobilemall.pk/) |
| 69 |
* Vietnamese – [Tuan Phan](https://profiles.wordpress.org/khunglong/) |
| 70 |
|
| 71 |
== Installation == |
| 72 |
|
| 73 |
= Automatic installation = |
| 74 |
|
| 75 |
1. Log into your WordPress admin |
| 76 |
2. Click __Plugins__ |
| 77 |
3. Click __Add New__ |
| 78 |
4. Search for __Code Snippets__ |
| 79 |
5. Click __Install Now__ under "Code Snippets" |
| 80 |
6. Activate the plugin |
| 81 |
|
| 82 |
= Manual installation = |
| 83 |
|
| 84 |
1. Download the plugin |
| 85 |
2. Extract the contents of the zip file |
| 86 |
3. Upload the contents of the zip file to the `wp-content/plugins/` folder of your WordPress installation |
| 87 |
4. Activate the Code Snippets plugin from 'Plugins' page. |
| 88 |
|
| 89 |
Network Activating Code Snippets through the Network Dashboard will enable a special interface for running snippets across the entire network. |
| 90 |
|
| 91 |
== Frequently Asked Questions == |
| 92 |
|
| 93 |
A full list of our Frequently Asked Questions can be found at [help.codesnippets.pro](https://help.codesnippets.pro/collection/3-faq). |
| 94 |
|
| 95 |
= How can I recover my site if it is crashed by a buggy snippet? = |
| 96 |
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>. |
| 97 |
|
| 98 |
= Will I lose my snippets if I change the theme or upgrade WordPress? = |
| 99 |
No, the snippets are stored in the WordPress database, independent of the theme and unaffected by WordPress upgrades. |
| 100 |
|
| 101 |
= Can the plugin be completely uninstalled? = |
| 102 |
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. |
| 103 |
|
| 104 |
= Can I copy snippets that I have created to another WordPress site? = |
| 105 |
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. |
| 106 |
|
| 107 |
= Can I export my snippets to PHP for a site where I'm not using the Code Snippets plugin? = |
| 108 |
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. |
| 109 |
|
| 110 |
= Can I run network-wide snippets on a multisite installation? = |
| 111 |
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. |
| 112 |
|
| 113 |
= Where are the snippets stored in my WordPress database? = |
| 114 |
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. |
| 115 |
|
| 116 |
= Where can I go for help or suggest new features? = |
| 117 |
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/sheabunge/code-snippets) |
| 118 |
|
| 119 |
= How can I help contribute to the development of the Code Snippets plugin? = |
| 120 |
The best way to do this is to fork the [repository on GitHub](https://github.com/sheabunge/code-snippets) and send a pull request. |
| 121 |
|
| 122 |
== Screenshots == |
| 123 |
|
| 124 |
1. Managing existing snippets |
| 125 |
2. Adding a new snippet |
| 126 |
3. Editing a snippet |
| 127 |
4. Importing snippets from an export file |
| 128 |
|
| 129 |
== Changelog == |
| 130 |
|
| 131 |
= 3.2.1 (05 Oct 2022) = |
| 132 |
* Fixed: Issue making survey reminder notice not dismissible. |
| 133 |
* Added: `Ctrl`+`/` or `Cmd`+`/` as shortcut for commenting out code in the snippet editor. |
| 134 |
* Added: Additional hooks to various snippet actions, thanks to contributions made by [ancient-spirit](https://github.com/ancient-spirit). |
| 135 |
* Added: Fold markers, additional keyboard shortcuts and keymap options to snippet editor, |
| 136 |
thanks to contributions made by [Amaral Krichman](https://github.com/karmaral). |
| 137 |
* Improved: Removed duplicate tables exist query. ([#](https://wordpress.org/support/topic/duplicate-queries-21)). |
| 138 |
* Improved: Enabled 'add paragraphs and formatting' option by default for newly inserted content snippets. |
| 139 |
* Added: WP-CLI commands for retrieving, activating, deactivating, deleting, creating, updating, exporting and importing snippets. |
| 140 |
* Fixed: Path to iron visible when updating the pro plugin. |
| 141 |
|
| 142 |
= 3.2.0 (22 July 2022) = |
| 143 |
* Fixed: Remove default value from SQL columns to improve compatibility with certain versions of MySQL. |
| 144 |
* Fixed: Delay loading snippets in Gutenberg editor blocks. (PRO) |
| 145 |
* Added: Option to show and hide line numbers in Gutenberg source code editor block. (PRO) |
| 146 |
* Added: Support for highlighting HTML, CSS, JS and embedded code in the front-end PrismJS code highlighter. |
| 147 |
* Added: Additional features to front-end PrismJS code highlighter, including automatic links and a copy button. |
| 148 |
* Added: Support for multiple code styles in the source code Gutenberg editor block. (PRO) |
| 149 |
* Added: Admin notice announcing release of Code Snippets Pro. |
| 150 |
* Fixed: Inconsistencies with translations between different plugin versions. |
| 151 |
* Fixed: Issue with Content Snippet shortcode information not displaying. |
| 152 |
* Added: Button for copying shortcode text to clipboard. |
| 153 |
* Improved: Include Code Snippets CSS and JS source code in distributed package. |
| 154 |
* Improved: Don't delete data from plugin if deleting Code Snippets Free while Code Snippets Pro is active. |
| 155 |
* Improved: Streamlined user interface and experience in Gutenberg editor blocks. (PRO) |
| 156 |
* Added: Option to choose from 44 different themes for the Prism code highlighter in the source editor block and Elementor widget. (PRO) |
| 157 |
* Improved: Compatibility of Elementor widgets with the latest version of Elementor. (PRO) |
| 158 |
* Improved: Replace icon font menu icon with embedded SVG icon. |
| 159 |
|
| 160 |
= 3.1.2 (3 July 2022) = |
| 161 |
* Updated external links and branding for Code Snippets Pro. |
| 162 |
* Improved: Add link URLs to settings pages, as an alternative to in-page navigation. |
| 163 |
* Fixed: Various fixes to block editor scripts. (PRO) |
| 164 |
* Fixed: Improved visual style of Gutenberg editor blocks. (PRO) |
| 165 |
|
| 166 |
= 3.1.1 (13 Jun 2022) = |
| 167 |
* Fixed: Download snippets feature not including snippet content. |
| 168 |
* Fixed: Alignment of 'opens externally' dashicon. |
| 169 |
* Improved: Added additional parameters to `code_snippets/export/filename` filter. |
| 170 |
|
| 171 |
= 3.1.0 (17 May 2022) = |
| 172 |
* Fixed: Caching inconsistencies preventing snippets and settings from refreshing on sites with persistent object caching. |
| 173 |
* Improved: Simplified database queries. |
| 174 |
* Added: More comprehensive cache coverage, including for active snippets. |
| 175 |
* Added: Icon to 'Go Pro' button indicating it opens an external tab. |
| 176 |
* Improved: Allow display styles in snippet descriptions. |
| 177 |
|
| 178 |
= 3.0.1 (14 May 2022) = |
| 179 |
* Fixed: Incompatibility issue with earlier versions of PHP. |
| 180 |
|
| 181 |
= 3.0.0 (14 May 2022) = |
| 182 |
|
| 183 |
__Added__ |
| 184 |
|
| 185 |
* Added: HTML content snippets for displaying as shortcodes or including in the page head or footer area. |
| 186 |
* Added: Notice reminding users to upgrade unsupported PHP versions. |
| 187 |
* Added: Visual settings to add attributes to shortcodes. |
| 188 |
* Added: Shortcode buttons to the post and page content editors. |
| 189 |
* Added: Basic REST API endpoints. |
| 190 |
* Added: Snippet type column to the snippets table. |
| 191 |
* Added: Snippet type badges to Edit and Add New Snippet pages. |
| 192 |
* Added: Setting to control whether the current line of the code editor is highlighted. |
| 193 |
* Added: Display a warning when saving a snippet with missing title or code. |
| 194 |
* Added: Add suffix to title of cloned snippets. |
| 195 |
|
| 196 |
__Changed__ |
| 197 |
|
| 198 |
* Improved: Updated plugin code to use namespaces, preventing name collisions with other plugins. |
| 199 |
* Improved: Added key for the 'active' and 'scope' database table columns to speed up queries. |
| 200 |
* Improved: Redirect from edit menu if not editing a valid snippet. |
| 201 |
* Improved: Moved activation switch into its own table column. |
| 202 |
* Improved: Updated code documentation according to WordPress standards. |
| 203 |
* Improved: Added snippet type labels to the tabs on the Snippets page. |
| 204 |
* Improved: Split settings page into tabs. |
| 205 |
* Improved: Use the version of CodeMirror included with WordPress where possible to inherit the additional built-in features. |
| 206 |
* Improved: Added hover effect to priority settings in the snippets table to show that they are editable. |
| 207 |
* Fixed: Snippets table layout on smaller screens. |
| 208 |
|
| 209 |
__Deprecated__ |
| 210 |
|
| 211 |
* Removed: Deprecated functions and compatibility code for unsupported PHP versions. |
| 212 |
* Removed: Option to disable snippet scopes. |
| 213 |
|
| 214 |
__New in Pro__ |
| 215 |
|
| 216 |
* Added: CSS style snippets for the site front-end and admin area. |
| 217 |
* Added: JavaScript snippets for the site head and body area on the front-end. |
| 218 |
* Added: Browser cache versioning for CSS and JavaScript snippets. |
| 219 |
* Added: Support for exporting and downloading CSS and JavaScript snippets. |
| 220 |
* Added: Support for highlighting code on the front-end. |
| 221 |
* Added: Editor syntax highlighting for CSS, JavaScript and HTML snippets. |
| 222 |
* Added: Button to preview full file when editing CSS or JavaScript snippets. |
| 223 |
* Added: Option to minify CSS and JavaScript snippets. |
| 224 |
* Added: Gutenberg editor block for displaying content snippets. |
| 225 |
* Added: Gutenberg editor block for displaying snippet source code. |
| 226 |
* Added: Elementor widget for displaying content snippets. |
| 227 |
* Added: Elementor widget for displaying snippet source code. |
| 228 |
|
| 229 |
= 2.14.6 (13 May 2022) = |
| 230 |
* Fixed: Issue with processing uploaded import files. |
| 231 |
* Fixed: Issue with processing tag filters. |
| 232 |
|
| 233 |
= 2.14.5 (10 May 2022) = |
| 234 |
* Fixed: Incompatibility issue with older versions of PHP. |
| 235 |
|
| 236 |
= 2.14.4 (5 May 2022) = |
| 237 |
* Fixed: Prevent array key errors when loading the snippet table with unknown order values. |
| 238 |
|
| 239 |
= 2.14.3 (10 Dec 2021) = |
| 240 |
* Fixed: Potential security issue outputting snippets-safe-mode query variable value as-is. Thanks to Krzysztof Zaj� |
| 241 |
c for reporting. |
| 242 |
|
| 243 |
= 2.14.2 (9 Sep 2021) = |
| 244 |
* Fixed: Prevent network snippets table from being created on single-site installs. |
| 245 |
* Added translations: |
| 246 |
- Spanish by [Ibidem Group](https://www.ibidemgroup.com) |
| 247 |
- Urdu by [Samuel Badree](https://mobilemall.pk/) |
| 248 |
- Greek by [Toni Bishop from Jrop](https://www.jrop.com/) |
| 249 |
* Added: Support for `:class` syntax to the code validator. |
| 250 |
* Added: PHP8 support to the code linter. |
| 251 |
* Added: Color picker feature to the code editor. |
| 252 |
* Added: Failsafe to prevent multiple versions of Code Snippets from running simultaneously. |
| 253 |
|
| 254 |
= 2.14.1 (10 Mar 2021) = |
| 255 |
* Added: Czech translation by [Lukáš Tesař](https://github.com/atomicf4ll). |
| 256 |
* Fixed: Code validator now supports `function_exists` and `class_exists` checks. |
| 257 |
* Fixed: Code validator now supports anonymous functions. |
| 258 |
* Fixed: Issue with saving the hidden columns setting. |
| 259 |
* Fixed: Replaced the outdated tag-it library with [tagger](https://github.com/jcubic/tagger) for powering the snippet tags editor. |
| 260 |
* Added: Code direction setting for RTL users. |
| 261 |
* Updated CodeMirror to version 5.59.4. |
| 262 |
* Added: Additional action hooks and search API thanks to [@Spreeuw](https://github.com/Spreeuw). |
| 263 |
|
| 264 |
= 2.14.0 (26 Jan 2020) = |
| 265 |
* Updated CodeMirror to version 5.50.2. |
| 266 |
* Added: Basic error checking for duplicate functions and classes. |
| 267 |
* Updated Italian translations to fix display issues – thanks to [Francesco Marino](https://360fun.net). |
| 268 |
* Fixed: Ordering snippets in the table by name will now be case-insensitive. |
| 269 |
* Added: Additional API options for retrieving snippets. |
| 270 |
* Fixed: Code editor will now properly highlight embedded HTML, CSS and JavaScript code. |
| 271 |
* Changed the indicator color for inactive snippets from red to grey. |
| 272 |
* Fixed a bug preventing the editor theme from being set to default. |
| 273 |
* Added: Store the time and date when each snippet was last modified. |
| 274 |
* Added: Basic error checking when activating snippets. |
| 275 |
* Fixed: Ensure that imported snippets are always inactive. |
| 276 |
* Fixed: Check the referer on the import menu to prevent CSRF attacks. Thanks to [Chloe with the Wordfence Threat Intelligence team](https://www.wordfence.com/blog/author/wfchloe/) for reporting. |
| 277 |
* Fixed: Ensure that individual snippet action links use proper verification. |
| 278 |
|
| 279 |
**[The full changelog is available on GitHub](https://github.com/sheabunge/code-snippets/blob/master/CHANGELOG.md)** |
| 280 |
|
| 281 |
== Upgrade Notice == |
| 282 |
|
| 283 |
= 3.2.1 = |
| 284 |
WP-CLI features in Code Snippets Pro: manage your snippets from the command line. |
| 285 |
|
