Code Snippet DM vs Syntax-highlighting Code Block (with Server-side Rendering)

Supports: Gutenberg, Elementor, TinyMCE and shortcode Display your code snippets in a stylish way inside your content. The plugin uses shortcodes and also very intuitive TinyMCE interface. Starting with v2.0.3, the plugin offers support to be used via a custom Elementor Widget. Starting with v2.0.1, the plugin offers support to be used via a custom Gutenberg block. It will continue to support the default way of adding the code snippet via shotcodes. Code Snippet DM was inspired by the Carbon project. We created a simple way to display your code snippets but also have control over the way it appears, thus making it more stylish. Also, on the front end in the top right you will find a Copy Code button that allows you to copy to clipboard the entired code snippet. The plugin provides you with a TinyMCE button that will allow you to display the code or an option to use a shortcode. You can open the shorcode [dm_code_snippet] and in the content inside and close it [/dm_code_snippet]. Elementor widget The Widget is called “Code Snippet DM” and can be found on the Basic list of Elementor Widget after you activate the plugin. Keywords that can be used to find it: code, snippet, dm. Once the widget is added in the Elementor editor, it can be customized via the sidebar settings that will appear for each widget. The sidebar will include all the settings that are available for the shortcode. Some of the settings will be applied in real time in your editor. The code styling (syntax highlight) and line numbers are only available on the front-end, in the editor you will not be able to preview the correct colors for the code or the line numbers. Gutenberg block The block is called “Code Snippet DM” and can be found in the embed section of Gutenberg blocks. Keywords that can be used to find it: code, snippet, dm. Once the block is added in the Gutenberg editor, it can be customized via the sidebar settings that will appear for each block. The sidebar will include all the settings that are available for the shortcode. Some of the settings will be applied in real time in your editor. The code styling (syntax highlight) and line numbers are only available on the front-end, in the editor you will not be able to preview the correct colors for the code or the line numbers. Shortcode Options There are a number of options that you can use in the shortcode: background with options yes or no will enable/disable the color background (Default yes) background-mobile with options yes or no will enable/disable the color background for mobile devices (Default yes) bg-color accepts any HEX, RGB or RGBA value to change the background color (Default #abb8c3) theme with options light or dark that changes the code editor theme (Default dark) slim with options yes or no that changes the code editor from default to a slim version, ideal for one-line code (Default no) line-numbers with options yes or no that will enable a left side line number for columns (Default no) language with options clike, css, javascript, markup, perl, php, python, ruby, sql, typescript, shell will highlight the syntaxes based on what you select for your code (Default php) wrap with options yes or no will wrap the code or add a horizontal scroll bar to display it as it is (Default no) height allows you to input any value and will set the code snippet height to that value. Example: 500px. (Default is empty) copy-text this is used for the text shown on the copy button. If it’s not added it will use the default option. (Default Copy Code) copy-confirmed this is used for the text shown after you click the copy button. If it’s not added it will use the default option. (Default Copied) Example of shortcode: [dm_code_snippet background="yes" background-mobile="yes" slim="no" line-numbers="no" bg-color="#abb8c3" theme="light" language="css" wrapped="no" height="500px" copy-text="Get the Code!" copy-confirmed="You have it!"] .dm-code-snippet.dark { background: $default-bg; padding: 40px 35px 45px 35px; margin: 30px 0; } [/dm_code_snippet] Important: * If you use the shortcode directly, make sure to wrap the code in as in the example above. * If you want to add HTML using the shortcode, you’ll need to escape the HTML before pasting it in the shortcode. (You can easily find an escape tool online to convert the code) * If you have code (not HTML) that uses ‘</’ and you add it with the shortcode and not the and the TinyMCE button, you will need to escape ‘</’ from your code in order to properly display it. Use the TinyMCE button if you don’t want to add the shortcode yourself. (see Screenshots)

This plugin extends the Code block in WordPress core to add syntax highlighting which is rendered on the server. Pre-existing Code blocks on a site are automatically extended to include syntax highlighting. Doing server-side syntax highlighting eliminates the need to enqueue any JavaScript on the frontend (e.g. Highlight.js or Prism.js) and this ensures there is no flash of unhighlighted code (FOUC?). Reducing script on the frontend improves frontend performance, and it also allows for the syntax highlighted code to appear properly in AMP pages as rendered by the official AMP plugin (see also ampproject/amp-wp#972) or when JavaScript is turned off in the browser. This extended Code block uses language auto-detection to add syntax highlighting, but you can override the language in the block’s settings sidebar. (There is currently no syntax highlighting of the Code block in the editor, but see #8.) The plugin supports all programming languages that highlight.php supports (being a port of highlight.js). The Code block also is extended to support specifying lines to highlight which get marked up with mark elements (including in RSS feeds). There is also a checkbox for whether to show line numbers on the frontend (with the numbers being non-selectable). Lastly, given inconsistencies across themes regarding whether lines in a Code block should be wrapped, this plugin adds styling to force them to no-wrap by default, with a checkbox to opt in to wrapping when desired. For advanced usage, please see the plugin wiki. This plugin is developed on GitHub. See list of current issues with the plugin. Please feel free to file any additional issues or requests that you may come across. Pull requests are welcome. See contributing information. Credits This is a fork of Code Syntax Block by Marcus Kazmierczak (mkaz), which is also available on WordPress.org. Copyright (c) 2018 Marcus Kazmierczak. Licensed under GPL 2.0 or later. highlight.php is released under the BSD 3-Clause License. Copyright © 2006-2013, Ivan Sagalaev ([email protected]), highlight.js (original author). Copyright © 2013, Geert Bergman ([email protected]), highlight.php