CommentPress Core is an open source theme and plugin for WordPress that allows readers to comment in the margins of a text. Readers may comment paragraph-by-paragraph, line-by-line, block-by-block or by selecting text (coming soon to touch devices).
Annotate, gloss, workshop, debate: with CommentPress Core you can do all of these things on a finer-grained level, turning a document into a conversation. It can be applied to a fixed document (paper/essay/book etc.) or to a running blog. Use it in combination with BuddyPress and Groupblogs to create communities around your documents.
Please note: for the time-being, this plugin works best when the Gutenberg editor is
disabled. If you want the simplest CommentPress experience in WordPress 5.x please install the
Classic Editor or
Gutenberg Ramp plugin to manage the post types on which the Gutenberg editor is enabled.
Please note: this plugin comes bundled with three official themes, one of which must be active for CommentPress Core to function. The "CommentPress Modern Theme" will be auto-activated when the plugin is first activated. The old "CommentPress Default Theme" is still included for those who wish to stay with it or have built their own child themes for it. Since version 3.9 a new "CommentPress Flat Theme" is included for those who want an alternative layout. If you are upgrading from a previous version of CommentPress (3.0.x - 3.3.x), please follow the instructions in the Installation section before doing so.
For further information and instructions please see the
CommentPress website or visit the plugin's
GitHub repository. Contact the developers by email at
cpdev@futureofthebook.org.
For sites hosted in the European Union, please note: the "CommentPress Default Theme" makes use of cookies, but for presentational purposes only. If you intend to use the "CommentPress Default Theme" on a public site, you may need to inform visitors of this.
Many thanks to the following for translations:
- French - Pouhiou
- Spanish - Andrew Kurtis from WebHostingHub
- Dutch - Gerrit Jan Dijkgraaf
- German - Chris Witte
You can download and install CommentPress Core using the built in WordPress plugin installer. If you download CommentPress Core manually, make sure it is uploaded to "/wp-content/plugins/commentpress-core/".
Install CommentPress Core in WordPress Standalone
Base Install:
- 安装WordPress
- Install "CommentPress Core"
- Activate "CommentPress Core"
Your basic "CommentPress Core" setup is complete. At this point you can:
- Create a custom menu for the main site
- Use the Theme Customizer to modify the look
- Change Background and Header
- Customise "CommentPress Core" via its Settings Page
Install CommentPress Core in WordPress Multisite
Base Install:
- Install WordPress
- Create Network
Okay, we're ready to install "CommentPress Core":
- Install and Network Activate "CommentPress Core"
- If you want to, you can enable "CommentPress Core" on your main blog
- Network Enable the "CommentPress Modern Theme", "CommentPress Flat Theme" and/or the "CommentPress Default Theme" UNLESS
- You have "CommentPress Core"-compatible child themes you want to use instead:
- Network Enable any "CommentPress Core"-compatible child themes you want to use
Go to the "CommentPress" network settings page under "Settings" in "Network Admin":
- Configure your options as desired
- Click "Save Changes"
Your basic "CommentPress Core" setup is complete. At this point you can:
- Create a custom menu for the main site
- Use the Theme Customizer to modify the look
- Change Background and Header
- Customise "CommentPress Core" via its Settings Page
Install CommentPress Core with BuddyPress Groupblogs
Base Install:
- Install WordPress
- Create Network
Essential Plugins:
- Install, Network Activate and configure "BuddyPress" (Please note: "CommentPress Core" has not been tested with the Forums component)
- Download and Network Activate the latest version of "BuddyPress Groupblog" greater than 1.8.3
Optional Plugins:
- Network Install "BuddyPress Group Email Subscription"
- Network Install "Invite Anyone"
- Network Install "My Page Order"
- Network Install "Co-Authors Plus"
- Network Install "Simple Footnotes" (recommended), "FD Footnotes" or "WP-Footnotes"
Okay, we're ready to install "CommentPress Core":
- Install and Network Activate "CommentPress Core"
- If you want to, you can enable "CommentPress Core" on your main blog
- Network Enable the "CommentPress Modern Theme", "CommentPress Flat Theme" and/or the "CommentPress Default Theme" UNLESS
- You have "CommentPress Core"-compatible child themes you want to use instead:
- Network Enable any "CommentPress Core"-compatible child themes you want to use
- Optionally, activate your chosen "CommentPress Core"-compatible child theme
Go to your "Groupblog Setup" page under "Settings" in "Network Admin":
- Select your desired "BuddyPress Groupblog" theme as your default "BuddyPress Groupblog" theme
- Click "Save Changes"
- Click the "Redirect" header
- Set "Redirect Enabled to:" to "Home Page"
- Click "Save Changes"
Go to the "CommentPress" network settings page under "Settings" in "Network Admin":
- Select your desired "CommentPress Groupblog" theme. This will be applied to group blogs that are "CommentPress Core"-enabled
- Configure other options as desired
- Click "Save Changes"
Your basic "CommentPress Groupblogs" setup is complete. At this point you can:
- Create a custom menu for the main site
- Use the Theme Customizer to modify the look
- Change Background and Header
- Customise "CommentPress Core" via its Settings Page
To create a "CommentPress Core"-enabled Groupblog:
- Begin to create a group as usual
- At the "Groupblog" screen, click "Enable CommentPress"
- Choose any further options
- Check the box for "Enable member blog posting" and use the default settings unless you have reason not to
- Continue and finish creating the group
- To go to the groupblog, click "Blog" (or "Workshop" if you have chosen that naming scheme)
- Start your group blogging!
Upgrades
Upgrades from previous versions of "CommentPress" are possible. Please follow the following procedures for your context.
The name has been changed from "CommentPress" to "CommentPress Core" for two reasons: (a) because it serves as the basis for extending it for your purposes and (b) to safeguard historical installations, which could break if they upgrade. Newer "CommentPress" installations (versions 3.0.x - 3.3.x) can upgrade to the current version.
Upgrade to CommentPress Core
It is recommended that you upgrade to the latest versions of WordPress as well as the latest versions of the old "CommentPress" plugins and theme before upgrading to "CommentPress Core", but "CommentPress Core" will do its best if this is not possible. A minimum of WordPress 3.3 is required, but upgrades under WordPress 3.4+ work much better. The old "CommentPress" plugins and theme can be found on Github:
- Get the latest CommentPress Plugin
- Get the latest CommentPress for Multisite
- Get the latest CommentPress Ajaxified
- Get the latest CommentPress Theme
Upgrade to CommentPress Core in WordPress Standalone
- Activate "CommentPress Core" plugin
- "CommentPress Core" will try and deactivate the "CommentPress Ajaxified" plugin. Deactivate it if it is still active.
- "CommentPress Core" will try and deactivate the "CommentPress" plugin. Deactivate it if it is still active.
- Delete "CommentPress Ajaxified" plugin
- Delete "CommentPress" plugin
Upgrade to CommentPress Core in WordPress Multisite (NOT network-activated)
On each site:
- Activate "CommentPress Core" plugin
- "CommentPress Core" will try and deactivate the "CommentPress Ajaxified" plugin. Deactivate it if it is still active.
- "CommentPress Core" will try and deactivate the "CommentPress" plugin. Deactivate it if it is still active.
When EVERY site has done this, go to Network Admin -> Plugins:
- Delete "CommentPress Ajaxified" plugin
- Delete "CommentPress" plugin
Upgrade to CommentPress Core (network-activated OR with BuddyPress Groupblogs)
To upgrade to CommentPress Core.
- Install, but DO NOT activate OR network-activate CommentPress Core.
- Network Deactivate "CommentPress for Multisite Extras", if present
- Network Deactivate "CommentPress for Multisite"
- Network Disable all old "CommentPress" child themes
- Now Network Activate "CommentPress Core"
"CommentPress Core" will now be active on your main site.
On each site:
- Activate "CommentPress Core" plugin
- "CommentPress Core" will try and deactivate the "CommentPress Ajaxified" plugin. Deactivate it if it is still active.
- "CommentPress Core" will try and deactivate the "CommentPress" plugin. Deactivate it if it is still active.
When EVERY site has done this, go to "Network Admin" -> "Plugins":
- Delete "CommentPress Ajaxified" plugin
- Delete "CommentPress" plugin (NOT "CommentPress Core"!)
- Delete "CommentPress for Multisite Extras", if present
- Delete "CommentPress for Multisite"
3.9.15
- Hide Activity Column comments section when there are none
- Style fixes for BuddyPress
3.9.14
- Allow themes when in multiste but not network-activated
3.9.13
- Style fixes for BuddyPress Docs compatibility
- Fix escape characters when editing a comment
3.9.12
- Introduces front-end AJAXified comment editing
- Supports "wp_body_open" function and action
3.9.11
- Restore compatibility with BP Groupblog plugin
- Improve meta description handling
3.9.10
- Prevents fatal error on some versions of PHP
3.9.9
- Prevents fatal error when BuddyPress Site Tracking component is not active
- Adds GeoMashup compatibility
- Better BuddyPress Docs compatibility
- Translation improvements
3.9.8
- Fixes date display when displaying Table of Contents as posts
- Fixes menu expansion on page load with unusual hierarchies
- German translation fixes
3.9.7
- Fixes error when BuddyPress Activity component is not active
3.9.6
- Introduce AJAX javascript setup filter
3.9.5
- Fix deployment to WordPress plugin repo
3.9.4
- Fix BuddyPress comment tracking on pages
- Fix BuddyPress activity stream filtering functionality
- Fix BuddyPress activity item target link when editing comments in WordPress admin
3.9.3
- Fix markup when using audio or video shortcodes in line-by-line context
3.9.2
- Javascript enhancement to allow hiding of comment sections with no comments
3.9.1
- Fix markup when captioned image is first element of content
3.9
- Introduce new "CommentPress Flat" parent theme
- Add widget areas to themes
- Introduce option to skip parsing entries with no comments
- Introduce option to disable auto-navigation on pages
3.8.9
- Fix appearance on link autocomplete popover in comment form
3.8.8
- Keyboard accessibility refinements
- Upgrade support for footnotes plugins
- Better styling of images in default theme
3.8.7
- Fix illegal character in BuddyPress stylesheet
3.8.6
- Remove BuddyPress templates from Plugin Directory repo
3.8.5
- Fix print layout in Chrome
- Remove BuddyPress templates and provide compatibility via CSS
- Update Groupblog compatibility
- Update Multisite compatibility
- Drop support for IE7 and under
3.8.4
- Fix AJAX commenting under https
- Fix font URL under https
- Fix text selection offsets
3.8.3
- Add theme support for built-in title tags
- Bump admin headings to h1
- Misc minor fixes (see Github commit list)
3.8.2
- Fix default theme header minimiser
- Fix footnotes scrolling
- Fix search when BuddyPress active on main site
3.8.1
- Fix workflow content tab switching
3.8
- New feature! Comment on text selections within paragraphs.
3.7
- Child theme template auto-discovery
- Limited compatibility with WP Front End Editor
3.6.2
- Update and fix BP compatibility
- Fix workflow input ID
3.6.1
- Update compatibility notice
- Update BP compatibility
- Remove deprecated function calls
3.6
- Compatibility with latest BuddyPress
- avoid AJAX errors for suspected spam comments
- respect password-protected post comment visibility
- additional hooks for plugins
3.5.7
- Critical fix to account for the change in the way comments are "walked" in WordPress 3.8
3.5.6
- Restores compatibility with JetPack 2.7 which parses content in the document head
3.5.5
- Introduces media insertion into comments via Add Media button when logged in
- Allows switching between Visual and HTML editor in comment form
- Introduces featured images to pages and posts
3.4 onwards
The merged plugins and theme.
Merging 3.3.6 to 3.4
The merging process for the plugins and theme.
Up to 3.3.6
Up to this version, "CommentPress" was a collection of separate plugins and a theme.