=== Code Snippets === Contributors: bungeshea, ver3 Donate link: https://sheabunge.com/donate Tags: code-snippets, snippets, code, php, network, multisite Requires at least: 3.6 Tested up to: 5.5.0 Requires PHP: 5.2 Stable tag: 2.14.0 License: MIT License URI: license.txt An easy, clean and simple way to run code snippets on your site. == Description == Code Snippets is an easy, clean and simple way to run PHP code snippets on your site. It removes the need to add custom snippets to your theme's `functions.php` file. 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. 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. 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. Code Snippets provides graphical interface, similar to the Plugins menu, for managing snippets. Snippets can can be activated and deactivated, just like plugins. 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 side, either in JSON for later importing by the Code Snippets plugin, or in PHP for creating your own plugin or theme. 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), or [join the community on Facebook](https://facebook.com/groups/codesnippetsplugin). 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). If you'd like to contribute to the plugin's code or translate it into another language, you can [fork the plugin on GitHub](https://github.com/sheabunge/code-snippets). = Translations = Code Snippets can be used in these different languages thanks to the following translators: * Danish - [Finn Sommer Jensen](https://profiles.wordpress.org/finnsommer/) * French – [momo-fr](https://www.momofr.net/) and [Shea Bunge](https://sheabunge.com) * Belarusian - [Hrank.com](https://www.hrank.com) * Brazilian Portuguese – [Bruno Borges](http://brunoborges.info) * French (Canada) - [Dominic Desbiens](https://www.dominicdesbiens.com/) * Indonesian - [Jordan Silaen from ChameleonJohn.com](https://www.chameleonjohn.com/) * German - [Mario Siegmann](https://web-alltag.de/), [Joerg Knoerchen](https://www.sensorgrafie.de/), and [David Decker](https://deckerweb.de) * Dutch - [Sander Spies](https://github.com/sander1) * Slovak - [Ján Fajčák](https://wp.sk) * Russian - [Alexander Samsonov](http://www.wordpressplugins.ru/administration/code-snippets.html) * Chinese - [Jincheng Shan](http://shanjincheng.com) * Croatian - [Borisa Djuraskovic from Web Hosting Hub](https://www.webhostinghub.com/) * Japanese - [mt8](https://mt8.biz/) == Installation == = Automatic installation = 1. Log into your WordPress admin 2. Click __Plugins__ 3. Click __Add New__ 4. Search for __Code Snippets__ 5. Click __Install Now__ under "Code Snippets" 6. Activate the plugin = Manual installation = 1. Download the plugin 2. Extract the contents of the zip file 3. Upload the contents of the zip file to the `wp-content/plugins/` folder of your WordPress installation 4. Activate the Code Snippets plugin from 'Plugins' page. Network Activating Code Snippets through the Network Dashboard will enable a special interface for running snippets across the entire network. == Frequently Asked Questions == = How do I insert snippets into the post text editor? = Snippets that you add to this plugin are not meant to be inserted into the text editor. Instead, they are run on your site just as if they were added to your functions.php file. = How can I recover my site if it is crashed by a buggy snippet? (method one) = You can try activating 'safe mode'. All snippets will not execute while safe mode is active, allowing you to access your site and deactivate the snippet that is causing the error. To activate safe mode, add the following line to your wp-config.php file, just before the line that reads `/* That's all, stop editing! Happy blogging. */`: define('CODE_SNIPPETS_SAFE_MODE', true); To turn safe mode off, either [comment out](https://php.net/manual/language.basic-syntax.comments.php) this line or delete it. = How can I recover my site if it is crashed by a buggy snippet? (method two) = You can enable safe mode on a per-page basis by appending `&snippets-safe-mode=1` to end of the current page's URL. While safe mode is active, all snippets will not execute, allowing you to login to your site and deactivate any snippets that are causing issues. For example, to see the WordPress admin area in safe mode, you would change the URL from this: https://yoursiteurl.com/wp-admin/admin.php?page=snippets … to this: https://yoursiteurl.com/wp-admin/admin.php?page=snippets&snippets-safe-mode=1 Or, for another example, if you were viewing a page on the front-end of your site, you could change a URL like this: https://yoursiteurl.com/about-us/ … to this: https://yoursiteurl.com/about-us/?snippets-safe-mode=1 This will only work if the current user is logged in as an administrator – other visitors will see your site as normal. = Can I search and replace text inside the code editor? = The code editor supports several search and replace commands, accessible through keyboard shortcuts: - `Ctrl-F` / `Cmd-F` – Begin searching - `Ctrl-G` / `Cmd-G` – Find the next instance of the search term - `Shift-Ctrl-G` / `Shift-Cmd-G` – Find the previous instance of the search term - `Shift-Ctrl-F` / `Cmd-Option-F` – Replace text - `Shift-Ctrl-R` / `Shift-Cmd-Option-F` – Replace all instances of text - `Alt-F` – Persistent search (dialog remains open, `Enter` to find next, `Shift-Enter` to find previous) = Will I lose my snippets if I change the theme or upgrade WordPress? = No, the snippets are stored in the WordPress database, independent of the theme and unaffected by WordPress upgrades. = Can the plugin be completely uninstalled? = 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 of the stored snippets. If you would like to preserve the snippets, ensure they are exported first. = Can I copy snippets that I have created to another WordPress site? = 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. = Can I export my snippets to PHP for a site where I'm not using the Code Snippets plugin? = 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. = Can I run network-wide snippets on a multisite installation? = 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. = Where are the snippets stored in my WordPress database? = 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. = Where can I go for help or suggest new features? = 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) = How can I help contribute to the development of the Code Snippets plugin? = The best way to do this is to fork the [repository on GitHuclassb](https://github.com/sheabunge/code-snippets) and send a pull request. == Screenshots == 1. Managing existing snippets 2. Adding a new snippet 3. Editing a snippet 4. Importing snippets from an export file == Changelog == = 2.14.0 (26 Jan 2020) = * Updated CodeMirror to version 5.50.2. * Added: Basic error checking for duplicate functions and classes. * Updated Italian translations to fix display issues – thanks to [Francesco Marino](https://360fun.net). * Fixed: Ordering snippets in the table by name will now be case-insensitive. * Added: Additional API options for retrieving snippets. * Fixed: Code editor will now properly highlight embedded HTML, CSS and JavaScript code. * Changed the indicator color for inactive snippets from red to grey. * Fixed a bug preventing the editor theme from being set to default. * Added: Store the time and date when each snippet was last modified. * Added: Basic error checking when activating snippets. * Fixed: Ensure that imported snippets are always inactive. * 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. * Fixed: Ensure that individual snippet action links use proper verification. = 2.13.3 (13 Mar 2019) = * Added: Hover effect to activation switches. * Added: Additional save buttons above snippet editor. * Added: List save keyboard shortcuts to the help tooltip. * Added: Change "no items found" message when search filters match nothing. * Fixed: Calling deprecated code in database upgrade process. * Fixed: Include snippet priority in export files. * Fixed: Use Unix newlines in code export file. * Updated CodeMirror to version 5.44.0. * Fixed: Correctly register snippet tables with WordPress to prevent database repair errors [[#](https://wordpress.org/support/topic/database-corrupted-4/)] * Fixed: CodeMirror indentation settings being applied incorrectly = 2.13.2 (25 Jan 2019) = * Removed potentially problematic cursor position saving feature = 2.13.1 (22 Jan 2019) = * Added: Add menu buttons to settings page for compact menu * Updated: French translation updated thanks to momo-fr * Fixed: Split code editor and tag editor scripts into their own files to prevent dependency errors * Fixed: Handling of single-use shared network snippets * Fixed: Minor translation template issues * Added: Help tooltop to snippet editor for keyboard shortcuts, thanks to Michael DeWitt * Improved: Added button for executing single-use snippets to snippets table * Added: Sample snippet for ordering snippets table by name by default * Updated CodeMirror to version 5.43.0 = 2.13.0 (17 Dec 2018) = * Added: Search/replace functionality to the snippet editor. [See here for a list of keyboard shortcuts.](https://codemirror.net/demo/search.html) [[#](https://wordpress.org/support/topic/feature-request-codemirror-search-and-replace/)] * Updated CodeMirror to version 5.42.0 * Added: Option to make admin menu more compact * Fixed: Problem clearing recently active snippet list * Improved: Integration between plugin and the CodeMirror library, to prevent collisions * Improved: Added additional styles to editor settings preview * Added: PHP linter to code editor * Improved: Use external scripts instead of inline scripts * Fixed: Missing functionality for 'Auto Close Brackets' and 'Highlight Selection Matches' settings = 2.12.1 (15 Nov 2018) = * Improved: CodeMirror updated to version 5.41.0 * Improved: Attempt to create database columns that might be missing after a table upgrade * Improved: Streamlined upgrade process * Fixed: Interface layout on sites using right-to-left languages * Improved: Made search box appear at top of page on mobile [[#](https://wordpress.org/support/topic/small-modification-for-mobile-ux/)] * Updated screenshots = 2.12.0 (23 Sep 2018) = * Fixed: Prevented hidden columns setting from reverting to default * Improved: Updated import page to improve usability * Improved: Added Import button next to page title on manage page * Improved: Added coloured banner indicating whether a snippet is active when editing * Update CodeMirror to 5.40.0 = 2.11.0 (24 Jul 2018) = * Added: Ability to assign a priority to snippets, to determine the order in which they are executed * Improvement: The editor cursor position will be preserved when saving a snippet * Added: Pressing Ctrl/Cmd + S while writing a snippet will save it * Added: Shadow opening PHP tag above the code editor * Improved: Updated the message shown when there are no snippets * Added: Install sample snippets when the plugin is installed * Improved: Show all available tags when selecting the tag field * Added: Filter hook for controlling the default list table view * Added: Action for cloning snippets = 2.10.2 (21 Jul 2018) = * Added: Button to reset settings to their default values * Improved: Made uninstall cleanup optional through a plugin setting * Fixed: Applied formatting filters to snippet descriptions in the table * Improved: Ordered tags by name in the filter dropdown menu * Fixed: Incorrectly translated strings * Added: Belarusian translation by Hrank.com * Improved: Enabled sorting snippets table by tags * Updated CodeMirror to version 5.39.0 = 2.10.1 (10 Feb 2018) = * Fixed: Prevent errors when trying to export no snippets * Fixed: Use wp_json_encode() to encode export data * Fixed: Check both the file extension and MIME type of uploaded import files = 2.10.0 (18 Jan 2018) = * Improved: Added support for importing from multiple export files at once * Improved: Unbold the titles of inactive snippets for greater visual distinction * Added: New scope for single-use snippets * Improved: Don't show network snippets on subsites by default, and only to super admins * Improved: Export snippets to JSON instead of XML * Improved: More options for importing duplicate snippets * Improved: Use strings for representing scopes internally instead of numbers * Added: Allowed plugin settings to be unified on multisite through Network Settings option * Fixed: Issue with incorrectly treating network snippets as site-wide for code validation * Improved: Rename 'Export to PHP' to 'Download', and add button to edit snippet page = 2.9.6 (14 Jan 2018) = * Added Brazilian Portuguese translation by [Bruno Borges](http://brunoborges.info) * Fixed: Use standard WordPress capabilities instead of custom capabilities to prevent lockouts * Fixed: Multisite issue with retrieving active shared snippets from the wrong table causing duplicate snippet execution * Moved scope and other settings on single snippet page to below code area = 2.9.5 (13 Jan 2018) = * Fixed: Undefined function error when accessing the database on multisite * Fixed: Ensured all admin headings are hierarchical for accessibility * Made the "Activate By Default" setting enabled by default for new installs * Updated CodeMirror to version 5.33 = 2.9.4 (19 Sep 2017) = * Fixed: Prevented PHP error from occurring when saving a snippet * Minor improvements to database creation function = 2.9.3 (11 Sep 2017) = * Fixed: Prevent snippets from being executed twice when saving due to invalid ID being passed to allow_execute_snippet filter * Fixed: Re-enabled output suppression when executing snippets = 2.9.2 (8 Sep 2017) = * Fixed: Do not attempt to combine queries for fetching local and multisite snippets = 2.9.1 (7 Sep 2017) = * Fixed: Prevent illegal mix of collations errors when fetching snippets from database tables with different collations [[#](https://wordpress.org/support/topic/issue-on-multisite-with-wpml/)] = 2.9.0 (6 Sep 2017) = * Fixed: Prevented invalid properties from being set when saving a snippet * Fixed: Use the correct protocol when saving a snippet * Improved: Moved code to disable snippet execution into a filter hook * Fixed: Active shared snippets not being updated correctly * Improved: execute_active_snippets() function updated with improved efficiency * Improved: Renamed Snippet class to avoid name collisions with other plugins * Improved: Don't hide output when executing a snippet * Updated CodeMirror to version 5.28.0 = 2.8.6 (14 May 2017) = * Ensure that get_snippets() function retrieves snippets with the correct 'network' setting. Fixes snippet edit links in network admin. * Fix snippet description field alias not mapping correctly = 2.8.5 (13 May 2017) = * Ensured HTML in snippet titles is escaped in snippets table * Added Indonesian translation by Jordan Silaen from ChameleonJohn.com * Disallowed undefined fields to be set on the Snippets class * Prevented shared network snippets from being included twice in snippets table on multisite * Added setting to hide network snippets on subsites = 2.8.4 (29 April 2017) = * Fixed all snippets being treated as network snippets on non-multisite sites = 2.8.3 (29 April 2017) = * Updated CodeMirror to version 5.25.0 * Show network active snippets as read-only on multisite subsites * Added more compete output escaping to prevent XSS errors = 2.8.2 (27 Feb 2017) = * Fix bug introduced in 2.8.1 that broke code verification functionality by executing code twice = 2.8.1 (25 Feb 2017) = * Updated German translation * Fixed admin menu items not translating * Removed possible conflict between Debug Bar Console plugin ([#](https://github.com/sheabunge/code-snippets/issues/52)) * Corrected editor alignment on RTL sites ([#](https://wordpress.org/support/topic/suggestion-css-fix-for-rtl-sites/)) * Fixed bulk actions running when Filter button is clicked ([#](https://wordpress.org/support/topic/bug-with-filtering-action-buttons/)) * Updated CodeMirror to version 5.24.0 = 2.8.0 (14 Dec 2016) = * Fixed Italian translation errors. Props to @arsenalemusica * Renamed 'Manage' admin menu label to 'All Snippets' to keep in line with other admin menu labels * Renamed placeholder on snippet name field to 'Enter title here' * Removed CodeMirror search functionality * Moved 'Edit Snippet' admin menu above 'Add New' menu * Made pressing Ctrl-Enter in the code editor save the snippet * Updated CodeMirror to version 5.21.0 = 2.7.3 (24 Oct 2016) = * Updated CodeMirror to version 5.10.0 * Fixed a few strings not being translated = 2.7.2 (1 Oct 2016) = * Updated German translation by [Mario Siegmann](https://web-alltag.de) = 2.7.1 (30 Sep 2016) = * Added Dutch translation by Sander Spies * Ensured that the editor theme setting is properly validated. Thanks to [Netsparker](https://www.netsparker.com) for reporting. * Ensured that snippet tags are properly escaped. Thanks to [Netsparker](https://www.netsparker.com) for reporting. * Updated CodeMirror to version 5.19.0 = 2.7.0 (23 July 2016) = * Fixed plugin translations being loaded * Increase default snippets per page so that all are usually shown * Fixed description field not being imported * Updated German translation by [Mario Siegmann](https://web-alltag.de) * Fixed issue with CodeMirror rubyblue theme [[#](https://wordpress.org/support/topic/a-problem-with-the-cursor-color-and-the-fix-that-worked-for-me)] * Added query var to disable snippet execution. To use, add `?snippets-safe-mode=true` to the URL * Fixed snippet fields not importing * Updated CodeMirror to version 5.17.0 * Fixed a minor XSS vulnerability discovered by Burak Kelebek [[#](https://wordpress.org/support/topic/security-vulnerability-20)] = 2.6.1 (10 Feb 2016) = * Updated German translation by [Mario Siegmann](https://web-alltag.de) * Fixed error catching not working correctly * Updated error catching to work with snippets including functions and classes * Fixed editor autoresizing = 2.6.0 (31 Dec 2015) = * Reconfigured plugin to use classloader and converted a lot of functional code into OOP code * Updated CodeMirror to version 5.10.0 * Added `[code_snippets]` shortcode for embedding snippet code in a post * Fixed broken snippet search feature [[#](https://wordpress.org/support/topic/search-is-not-working-6)] * Added front-end syntax highlighting for shortcode using [PrismJS](https://prismjs.com) = 2.5.1 (11 Oct 2016) = * Fixed: Ensure errors are fatal before catching them during error checking * Fixed: Escape the snippet name on the edit page to ensure it displays correctly * Fixed: Exclude snippets with named functions from error checking so they do not run twice = 2.5.0 (8 Oct 2015) = * Added: Detect parse and fatal errors in code when saving a snippet, and display a user-friendly message * Fixed: Updated access of some methods in Code_Snippets_List_Table class to match updated WP_List_Table class = 2.4.2 (27 Sep 2015) = * Added query variable to activate safe mode * Fixed settings not saving * Fixed snippet descriptions not displaying on manage menu * Added settings to disable description and tag editors * Fixed: Load CodeMirror after plugin styles to fix error with Zenburn theme * Fixed: Hide snippet scope icons when the scope selector is disabled * Fixed description heading on edt snippet menu being hidden when visual editor disabled * Updated editor preview updating code to use vanilla JavaScript instead of jQuery * Fixed: Deactivate a shared network snippet on all subsites when it looses its sharing status = 2.4.1 (17 Sep 2015) = * Fixed CodeMirror themes not being detected on settings page [[#](https://wordpress.org/support/topic/updated-to-240-now-i-cant-switch-theme)] = 2.4.0 (17 Sep 2015) = * Added ability to share network snippets to individual sites on WordPress multisite * Improved code directory and class structure * Remove legacy code for pre-3.6 compatibility * Improved code for printing admin messages * Updated German translation (Joerg Knoerchen) * Added `code_snippets/after_execute_snippet` filter * Added class for individual snippets * Updated `get_snippets()` function to retrieve individual snippets * Removed scope statuses and added fixed tags to indicate scope * Changed admin page headers to use `