Enables in-place expansion of excerpts in the admin dashboard 'Comments' section of the 'Activity' widget to view full comments.
By default, the ‘Comments’ section of the ‘Activity’ admin dashboard widget only shows an excerpt for the comments, truncating the content of the comments to the first 20 words while at the same time stripping out all markup.
This plugin adds a link at the end of the comment actions row (the links for the comment that become visible under the comment when you hover over the comment). The “Show more” link, when clicked, will replace the excerpt with the full comment. The full comment will include all markup, including originally utilized markup and changes applied via filters, plugins, etc (such as shortcode expansion, smilies, paragraphing, etc). The full comment can be switched back to the excerpt by clicking the “Show less” link (which replaces the “Show more” link when the comment is expanded).
“In-place expansion” refers to the ability to click the link to see the full comment and it will be presented in place of the excerpt without requiring a page reload or navigation.
NOTE: This plugin only works for users who have JavaScript enabled.
Links: Plugin Homepage | Plugin Directory Page | GitHub | Author Homepage
The plugin exposes one filter for hooking. Such code should ideally be put into a mu-plugin or site-specific plugin (which is beyond the scope of this readme to explain).
c2c_expandable_dashboard_recent_comments_start_expanded (filter)
The ‘c2c_expandable_dashboard_recent_comments_start_expanded’ hook allows you to configure the ‘Recent Comments’ admin dashboard widget initially display all comments in their expanded state (i.e. not excerpted).
Arguments:
Example:
// Initially show dashboard comments fully expanded add_filter( 'c2c_expandable_dashboard_recent_comments_start_expanded', '__return_true' );
expandable-dashboard-recent-comments.zip
inside the plugins directory for your site (typically wp-content/plugins/
)A screenshot of the 'Recent Comments' admin dashboard widget with the plugin active, showing comments that have been truncated/excerpted by WordPress (the 2nd and 4th listed) and full, short comments. The third comment has the mouse over it (though the cursor doesn't appear in the screenshot) so you can see the action links, including the "Show more" link. Note, also, the 'Expand All' and 'Collapse All' links added to the bottom of the widget.
A screenshot of the 'Recent Comments' admin dashboard page with the plugin active, now showing the second excerpted comment (the third comment in the list) fully in-place expanded and with markup and formatting applied.
When you hover over the comment, a line of action links will appear (typically “Approve”, “Reply”, “Edit”, “Spam”, and “Trash”). If the comment has been automatically excerpted by WordPress, then a “Show more” link will appear. Click it to view the full comment.
The comment has not been been excerpted; you are already seeing the comment in its entirety so there is no need to be able to “show more”.
Assuming you are using a supported version of WordPress and you have JavaScript enabled in your browser, this just means that none of the comments being listed have been excerpted, thus there is no need to be able to “Expand all” or “Collapse all” in this instance.
If all of the comments in the widget are currently collapsed, then the “Collapse all” link will appear grayed out to indicate there is nothing for it to collapse. Likewise, if all of the comments in the widget are currently expanded, then “Expand all” will appear grayed out to indicate there is nothing for it to expand. As comments are expanded and collapsed, these two links will adjust themselves to appear grayed out or active as appropriate.
Yes. Please see the “Hooks” section for documentation on the c2c_expandable_dashboard_recent_comments_start_expanded
filter which allows for this.
If JavaScript is disabled in a visitor’s browser, then all of the expand/collapse links and behavior aren’t enabled. But rest assured, there aren’t any errors. Why not implement a fallback if JS is disabled? If you’re going to click a link that causes a page reload to view the full comment, you might as well just click through to the comment.
Yes.
phpunit/
into tests/
phpunit/bin
into tests/
Highlights:
Details:
get_comment_class()
phpunit/
to house all files related to unit testingbin/
to phpunit/bin/
tests/bootstrap.php
to phpunit/
tests/
to phpunit/tests/
phpunit.xml
to phpunit.xml.dist
per best practicescomment_row_action()
, enqueue_admin_css()
, enqueue_admin_js()
, get_comment_class()
, register_styles()
c2c_expandable_dashboard_recent_comments_start_expanded
filterget_comments_class()
from private
to protected
to facilitate unit testingFull changelog is available in CHANGELOG.md.