MCEngine – Instructions

Download the zip file from the MCEngine page and follow the standard plugin installation procedure.

The MCEngine pop-up window

When a user lands on a post or page MCEngine will insert a link at the end of each paragraph, list or table. Clicking the link will open a comment window and highlight the section they are commenting on.

If a user highlights any text before they click the comment link, the text will be copied in to the comment box automatically.

That’s it.

By default MCEngine installs and activates in Basic mode with comments visible to all and the comment facility available to all. You can change these settings using the MCEngine settings page which you will find in the Settings section of your admin panel.

The basic option

MCEngine can be enabled to work on posts, pages or posts and pages. When enabled MCEngine operates in three mode:

  • Basic: MCEngine will add comment forms ‘on the fly’ when a post displays. Be careful! When you edit the post comments may be lost or mixed up.
  • HTML: MCEngine will add extra mark-up to your post when you save it. This puts a hard-coded reference for each element (an HTML class). This means the relationship between comments and elements is maintained even if you edit the post. All elements are added by default but you can turn off comments for sections of a post by changing the class to MCE_no.
  • Shortcode: Like HTML mode but you can add a shortcode to decide what can be commented on when the post is displayed.

You can also control who can see and leave comments:

  • Everybody – any visitor to the post can see and leave comments
  • Logged in users – this can be anyone with a login which includes subscribers
  • Author and admin – only the blog admin and the blog author can see the comments (it also includes any editors as it’s based on the capability to edit posts)
  • Blog admin – only administrators can see the comments or leave comments

Advanced settings

The following advanced settings are available:

  • Allow post and page level overide – this adds an option to the post and page edit screens to turn MCEngine off for the post.
  • Force MCEngine to respect individual post comment settings – with this checked MCEngine will respect the comment settings in the discussion options on the edit page (not the general blog settings).
  • Hide ‘legacy’ comments – if a page or post is updated then some comments may not be relevant anymore. You can force MCEngine to hide older comments from the comment list. If you leave this unchecked then MCEngine will identify ‘legacy comments’ with a short note.
  • Limit MCEngine to post category and Category for comments – use this option to restrict MCEngine to one category. Use the Category for comments to identify the category in which to apply MCEngine.
  • Enable the MCEngine-like-Winerlinks mode – Makes MCEngine work like Dave Winer’s Winer Links. This essentially turns the comment part of the plugin off but but generates a hash link at the end of each element that you can use as an anchor. You may want to think about how you would use this. With this enabled, the plugin still respects the post and page level option to turn comments on and off and will also respect the MCE_no class.

Further settings for MCE

These options control the SelectShare functionality of MCEngine.  With SelectShare enabled the user can select a portion of text and then share the text using email, Twitter or Facebook.

The SelectShare pop-up window.

You also have a number of options for the selectshare pop-up. The Selectshare class the most important element.

  • Title – the title of the pop-up window
  • Border Colour – the pop-up border colour
  • Hover Colour – the background colour of each option as you roll-over it
  • Selectshare class – select share applies to elements within a certain class. By default it uses #content which  is the id for the main <div> that contains the post content.  If your template uses a different ID you can change that here or restrict the option further with your own id or class.
  • Author email –the email address you want user to use to contact you. SelectShare uses a simple mailto: call, so it will open up the users default email client to send the mail. So chose an email you don’t mind people seeing.
  • Blog Name – the name of your blog. This will take the blog name from your settings by default.
  • Blog URL – the web address for your blog. This will take the blog url from your settings by default.
  • Custom class – a custom class that you can use to apply styling from your own stylesheet.

SelectShare will also grab the URL to your post to add to Twitter and Facebook.

I’m using HTML mode but would like to turn MCEngine off for certain paragraphs. Can I do that?

Turn off MCEngine for specific elements when using HTML mode

Yes.  When you save a draft or publish the post MCEngine will add a CSS class to the elements on the page.

  • Switch to HTML view
  • Find the section you want to turn comments off for
  • Change the class to MCE_no e.g. from MCE_1234 to MCE_no.

Can I use MCEngine on draft posts or pages?

Yes. You can leave comments in the normal way using a draft. When anyone previews the page or post, they will see the comments in the normal way.  If you want to hide those comments when the post is published you can use the legacy comments option or you can unapprove or delete the comments in the normal way.

Can I mix and match HMTL, shortcode and basic content?

Yes. If, for example, you have a post created in HTML mode then select basic MCEngine will still render the HTML comments.

2 Replies to “MCEngine – Instructions”

  1. I wanted to look for journalists who are having problems with their job to post their issues anonymously on my blog dash30dash.org.

    Please let me know if you can help….

  2. I wanna say this is a wonderful plugin for WordPress, esp. for a knowledge management blog site.

    I hope greatly you can continue improving this plugin.
    1. optimize the comment box; enable saving comments if commentator click comments without inputing name / email.
    2. remove 0 count after each paragraph.
    3. after submitting a comment, allow the commentator to click a certain comment shown in the bottom to go back to the belonging paragraph if applicable.

    Thanks. You did a great a job!

Leave a Reply