Code Snippet DM vs Insert Pages

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)

Insert Pages lets you embed any WordPress content (e.g., pages, posts, custom post types) into other WordPress content using the Shortcode API. It also includes a widget for inserting pages into any widget area. The real power of Insert Pages comes when you start creating custom post types, either programmatically in your theme, or using another plugin like Custom Post Type UI. You can then abstract away common data types (like videos, quizzes, due dates) into their own custom post types, and then show those pieces of content within your normal pages and posts by Inserting them as a shortcode. Advanced Tutorial Contributor Wes Modes has graciously written an updated tutorial for the Gutenberg era, focused on creating a custom post type with custom fields and a custom template for rendering content. Read it here: https://medium.com/@wesmodes/using-wordpress-insert-pages-plugin-with-your-custom-post-types-and-custom-templates-535c141f9635 Example: Normal Use Case Say you teach a course and you’re constantly referring to an assignment due date in your course website. The next semester the due date changes, and you have to go change all of the locations you referred to it. Instead, you’d rather just change the date once! With Insert Pages, you can do the following: Create a custom post type called Due Date. Create a new Due Date called Assignment 1 Due Date with Fri Nov 22, 2013 as its content. Edit all the pages where the due date occurs and use the Insert Pages toolbar button to insert a reference to the Due Date you just created. Be sure to set the Display to Content so Fri Nov 22, 2013 shows wherever you insert it. The shortcode you just created should look something like this: [insert page='assignment-1-due-date' display='content'] That’s it! Now, when you want to change the due date, just edit the Assignment 1 Due Date custom post you created, and it will automatically be updated on all the pages you inserted it on. Example: Advanced Use Case Say your site has a lot of video content, and you want to include video transcripts and video lengths along with the videos wherever you show them. You could just paste the transcripts into the page content under the video, but then you’d have to do this on every page the video showed on. (It’s also just a bad idea, architecturally!) With Insert Pages, you can use a custom post type and create a custom theme template to display your videos+transcripts+lengths just the way you want! Create a custom post type called Video. Use a plugin like Advanced Custom Fields to add extra fields to your new Video custom post type. Add a Video URL field, a Transcript field, and a Video Length field. Create a new Video called My Awesome Video with the following values in its fields: Video URL: http://www.youtube.com/watch?v=oHg5SJYRHA0 Transcript: We’re no strangers to love, You know the rules and so do I… Video Length: 3:34 Create a template in your theme so we can display the video content as we want. I won’t cover this step here since it’s pretty involved, but you can find more help in the WordPress Codex. Let’s assume you created a template called Video with transcript (video-with-transcript.php) that shows the youtube video in a fancybox, and includes a button that shows the text transcript when a user clicks on it. Edit the pages where you want the video to show up and use the Insert Pages toolbar button to insert a reference to the Video you just created. Be sure to set the Display to Use a custom template, and select your new template Video with transcript. The shortcode you just created should look something like this: [insert page='my-awesome-video' display='video-with-transcript.php'] That’s it! Now you can create all sorts of video content and know that it’s being tracked cleanly in the database as its own custom post type, and you can place videos all over your site and not worry about lots of duplicate content. The possibilities are endless!