Solution to render Shortcodes in Admin Editor

3 comments

1. It’s actually not too bad to do what you’re asking. This should take you about an hour to do your first one, and 10 minutes to do subsequent ones.

   Ultimately what you’re going to do is create a TinyMCE plugin. Here’s what you should arm yourself with to start:

   1. General guide to creating a tinymce plugin
   2. Example code from WordPress Core
   3. A general guide on adding a TinyMCE plugin to WordPress. I found this one, which seems adequate.

   You now have all the tools to get ‘er done! Of all this, the code that will be of most interest to you is this block in the WP example code:

   4   function replaceGalleryShortcodes( content ) {
   5       return content.replace( /[gallery([^]]*)]/g, function( match ) {
   6           return html( 'wp-gallery', match );
   7       });
   8   }
   9
   10  function html( cls, data ) {
   11      data = window.encodeURIComponent( data );
   12      return '<img src="' + tinymce.Env.transparentSrc + '" class="wp-media mceItem ' + cls + '" ' +
   13          'data-wp-media="' + data + '" data-mce-resize="false" data-mce-placeholder="1" alt="" />';
   14  }
   

   Here, the shortcode for a gallery gets replaced with an img tag. The img tag has the class wp-gallery, which gets styled by the CSS found here.

   Edit 2016-04-06: Updated content and links for TinyMCE 4 and WordPress 4.4

   Log in to Reply

2. This is not a complete answer, just an design direction. I think the best approach is something like this:

   In the admin edit post

   Rip all the shortcodes from the saved post and render it inside a metabox, aside from the editor. Make shure they appears in the same order as the shortcodes occur in the tiny Editor.

   In tinyMCE javascript API

   Make a jQuery function, when user click on a shortcode, it swaps the HTML from the metabox into the editor. And vice versa. The order itselfs should be ok as association, but Im not shure about enclosing shortcodes. However there is many ways to design a nice ID-connection. The updates of shortcodes can be done on the fly with ajax.

   Never save the rendered shortcode state

   Before switch editors, save drafts, autodrafts and publish, make a API call to trigger the restore, so the rendered shortcode state never get saved…

   This can be done, but you need to be familar with the tinyMCE API to understand where and when to access the contents of the editor, and hook into javascript actions before ‘save’ and more.

   There can be several tinyMCE editor on the same edit post pageload.

   The restore part can be investigated by looking at the [gallery] shortcode beaviour. But the click on [MY_SHORTCODE] has to be done by some jQuery tricks.

   in the admin_footer script, access the content of where the cursor is active with:

   var $editor_content = $(tinymce.activeEditor.getBody());
   

   is a hint of how to start.

   Log in to Reply

3. I was looking for a way to graphically display and tweak shortcodes too. And now, finally, I found a tutorial that does exactly that: https://generatewp.com/take-shortcodes-ultimate-level/

   

   I add the description so that search engines pick it up:

   We are going to create a simple plugin with a shortcode, then we are
   going to add a TinyMCE editor button to insert that shortcode trough a
   popup which will collect all of the user input for the shortcode
   attributes. Then, we are going to replace the shortcode in the TinyMCE
   editor with a placeholder image, much like the native gallery of
   WordPress (which is actually a shortcode, in case you didn’t know),
   and last – we are going to allow editing of the shortcode and its
   attributes by double clicking on the placeholder image.

   Log in to Reply