Code Snippet DM vs Code Embed

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)

IMPORTANT: If updating from an earlier version of the plugin, please check the section named “Plugin Behaviour Changes”, below, for anything which could impact your existing set-up Code Embed allows you to embed code (JavaScript, CSS and HTML – it can’t be used for server-side code, such as PHP) in a post, without the content being changed by the editor. This is incredibly useful for embedding third-party scripts, etc. The plugin is used by many large sites, including Mozilla. Key features include… Add HTML or JavaScript to posts or pages – particularly useful for embedding videos! Embed in widgets using the Widget Logic plugin. Global embedding allows you to set up some code in one post or page and then access it from another. Modify the keywords or identifiers used for embedding the code to your own choice. Search for embedding code via a simple search option. Add a simple suffix to the embed code to convert videos to responsive output. Embed an external script directly using just the URL. Conforms to WCAG 2.1 AA standards. And much, much more! Iconography is courtesy of the very talented Janki Rathod. Please visit the Github page for the latest code development, planned enhancements and known issues. Getting Started To use this plugin, you need to have custom fields enabled on your site. If you’re using the block editor, you may need to switch this on first – please scroll down to the next section to learn how to do this. If you’re using the classic editor, then you’ll find the custom fields at the bottom of the editor screen. Although this plugin works for both posts and pages, for simplicity I will simply refer to posts – bear in mind that pages work in the same way. Once you have custom fields switched on, here’s how easy it is to use… Once you have the plugin installed, start a new post. Scroll down to the bottom of the screen and look for the “Custom Fields” section. Under “Add New Custom Field”, enter a name of CODE1 and your embed code as the value. In your post content, add {{CODE1}} where you wish the embed code to appear. And that’s it – when the post is viewed or previewed, {{CODE1}} will be replaced with the code that you asked to be embedded. This should get you started – for more information and advanced options, please see below. Alternatively, there’s a fantastic guide at Elftronix which I would recommend. Using this plugin with the block editor (aka Gutenberg) By default, custom fields are hidden inside the block editor but can be revealed. Edit or create a post. Click the settings button (three dots) in the top right-hand corner. Go to Preferences. Click the Panels tab. You will find a button to toggle the ‘Custom Fields’ meta box – make sure this is toggled to “on”. A button should appear titled “Enable & Reload” – you’ll need to click on that and wait for the page to reload before the custom fields will appear. Check out the screenshots for how the custom fields should look. I can’t find the custom fields For block editor users, I’m assuming you’ve done the above. For classic editor users, the custom fields should be present by default. In all cases they should appear at the bottom of the editor screen. From version 2.4, anyone without the “unfiltered HTML” capability won’t be able to use custom fields, for added security. Please see the section “Custom Field Security”, below, for more details. If none of the above applies, then you may have a theme or plugin that removes this or may have a problem with your WordPress installation – you will need to try the usual diagnostics to try and resolve this, including requesting help on the WordPress support forum. The Code Embed Options Screen While in WP Admin, if you go to Settings -> Code Embed, you’ll be able to access the options that are available for this plugin. Code embedding is performed via a special keyword that you must use to uniquely identify where you wish the code to appear. This consists of an opening identifier (something that goes at the beginning), a keyword and then a closing identifier. You may also add a suffix to the end of the keyword if you wish to embed multiple pieces of code within the same post. From this options screen, you can specify the above identifier that you wish to use. By default, the opening and closing identifiers are double braces and the keyword is CODE. During these instructions these will be used in all examples. The options screen is only available to those with a capability to manage options or greater. All the other Code Embed menu options are available to users with a capability to edit posts or greater. How to Embed Code To embed in a post, you need to find the meta box under the post named “Custom Fields”. If this is missing, you may need to add it by clicking on the “Screen Options” tab at the top of the new post screen. Now create a new custom field with the name of your keyword – e.g. CODE. The value of this field will be the code that you wish to embed. Save this custom field. Now, wherever you wish the code to appear in your post, simply put the full identifier (opening, keyword and closing characters). For example, {{CODE}}. If you wish to embed multiple pieces of code within a post, you can add a suffix to the keyword. So we may set up 2 custom fields named CODE1 and CODE2. Then in our post we would specify either {{CODE1}} or {{CODE2}} depending on which you wish to display. Don’t forget – via the options screen you can change any part of this identifier to your own taste. How to Embed Code from an External URL If you specify a URL within your post, surrounded by your choice of identifiers, then the contents of the URL will be embedded within your post. Obviously, be careful when embedding a URL that you have no control over, as this may be used to hijack your post by injecting, for example, dangerous JavaScript. For example, using the default options, you could embed the contents of a URL using the following method… {{http://www.example.com/code.php}} or {{https://www.example.com/code.html}} How to Use Global Embedding You can also create global embeds – that is, creating one piece of embed code and using it in multiple posts or pages. To do this, simply make reference to an already defined (but unique) piece of embed code from another post or page. So, let’s say in one post you define a custom field named CODE1. You can, if you wish, place {{CODE1}} not just in that post but also in another and it will work. However, bear in mind that the embed code name must be unique – you can’t have defined it in multiple posts, otherwise the plugin won’t know which one you’re referring to (although it will report this and list the posts that it has been used in). In the administration menu, there is a sidebar menu named “Tools”. Under this is a sub-menu named “Code Search”. Use this to search for specific embed names and it will list all the posts/pages that they’re used on, along with the code for each. Embedding in Widgets Natively, you cannot use the embed facilities within sidebar widgets. However, if you install the plugin Widget Logic, then Code Embed has been set up to make use of this and add the ability. Install Widget Logic and activate. In Administration, select the Widgets page from the Appearance menu. At the bottom there will be a set of Widget Logic options. Ensure ‘Use widget_content filter’ is ticked and press Save. Although you cannot set up embed code within a widget, you can make reference to it, for example by writing {{CODE1}} in the widget. Responsive Output Conversion Responsive output is where an element on a web page dynamically resizes depending upon the current available size. Most video embeds, for instance, will be a fixed size. This is fine if your website is also of a fixed size; however, if you have a responsive site then this is not suitable. Code Embed provides a simple suffix that can be added to an embed code and will convert the output to being responsive. This works best with videos. To use, when adding the embed code onto the page, simply add _RES to the end, before the final identifier. For example, {{CODE1_RES}}. The _RES should not be added to the custom fields definition. This will now output the embedded code at full width, dynamically resizing as required. If you don’t wish the output to be full width, you can specify a maximum width by adding an additional _x on the end, where x is the required width in pixels. For example, {{CODE1_RES_500}} will output CODE1 as responsive but with a maximum width of 500 pixels. It should be noted that this is an experimental addition and will not work in all circumstances. Embedding in excerpts By default, embed code will not appear in excerpts. However, you can switch this ability on via the Code Embed options screen. If you do this, then the standard rules of excerpts will still apply but only once the code embed has been applied. For example, excerpts are just text, a specific length, etc. Filtering of code By default, WordPress allows unfiltered HTML to be used by users in post custom fields, even if their role is set up otherwise. This opens up the possibility of leaving a site vulnerable, if any plugins that use this data don’t check it appropriately. “Out of the box,” neither the contributor nor author roles have unfiltered HTML capabilities but can access custom post fields. As this plugin requires the use of unfiltered HTML, we need to ensure that only authorized users can use it. From version 2.5, any users without this permission that update a post containing embeds from this plugin will cause the code to be filtered. Plugin Behaviour Changes Security hardening has meant that some changes to behaviour have had to change after specific releases. Here I’ll document any known changes… Version 2.6.4 – A global embed will now have scripts stripped on any post authored by a user without unfiltered_html. Safe-HTML global embeds (iframes, video, etc.) are unaffected. Previously scripts rendered everywhere. Version 2.6.4 – Global embeds stored on a draft/private post stop resolving on the front end. If you (or your users) deliberately keep a “global embed library” as an unpublished post, that pattern breaks – they’d need to publish it Version 2.6.3 – Global embeds are now case-sensitive (which it always should have been). If any existing live content relies on accidental case-insensitive matching (e.g. {{CODE1}} pulling a code1 field), it will stop resolving Reviews & Mentions “Works like a dream. Fantastic!” – Anita. “Thank you for this plugin. I tried numerous other iframe plugins and none of them would work for me! This plugin worked like a charm the FIRST time.” – KerryAnn May. Embedding content – WSD Blogging Server. Animating images with PhotoPeach – Cómo hago.