Description
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
Hooks
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:
- $default (boolean): The default state, which is âfalseâ (therefore comments are initially shown excerpted)
- $comment (object) : The comment object being displayed
Example:
// Initially show dashboard comments fully expanded
add_filter( 'c2c_expandable_dashboard_recent_comments_start_expanded', '__return_true' );
Screenshots
Installation
- Install via the built-in WordPress plugin installer. Or download and unzip
expandable-dashboard-recent-comments.zip
inside the plugins directory for your site (typicallywp-content/plugins/
) - Activate the plugin through the âPluginsâ admin menu in WordPress
- Visit the admin dashboard and check out the âCommentsâ section of the âActivityâ widget (assuming you have recent comments and that one or more of them have been automatically excerpted)
FAQ
-
How do I expand an excerpted comment?
-
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.
-
Why don’t I see the âShow moreâ link when hovering over a 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â.
-
Why don’t I see the âExpand allâ and âCollapse allâ links at the bottom of the widget?
-
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.
-
Why does either of the âExpand allâ or âCollapse allâ links appear grayed out?
-
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.
-
Can I make it so all comments initially appear fully expanded without needing to click the links to expand them?
-
Yes. Please see the âHooksâ section for documentation on the
c2c_expandable_dashboard_recent_comments_start_expanded
filter which allows for this. -
Does this work if JavaScript has been disabled in my browser?
-
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.
-
Does this plugin include unit tests?
-
Yes. The tests are not packaged in the release .zip file or included in plugins.svn.wordpress.org, but can be found in the plugin’s GitHub repository.
Contributors & Developers
“Expandable Dashboard Recent Comments” is open source software. The following people have contributed to this plugin.
Contributors“Expandable Dashboard Recent Comments” has been translated into 3 locales. Thank you to the translators for their contributions.
Translate “Expandable Dashboard Recent Comments” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
3.0 (2024-09-08)
Highlights:
This notable update features improvements for accessiblity via ARIA attributes, relocates the various expand/collapse links, notes compatibility through WP 6.6+, updates unit tests and removes them from release packaging, updates copyright date (2024), and other internal improvements.
Details:
- UI:
- New: Add ARIA attributes to improve accessibility
- Add
aria-controls
andaria-expanded
attributes to excerpt toggle links - Add
aria-hidden
attributes to comments excerpt and fulldiv
s as appropriate
- Add
- Change: Move the âShow more/lessâ links inline with the excerpt and full comment body rather than being comment row actions
- Change: Move the âCollapse/Expand allâ links to alongside the comment filter links rather than below
- Change: Add âcountâ class to the âExpand/Collapse Allâ links to match styling of WP admin
- Change: Add separator before âExpand Allâ link since the preceeding âTrashâ link omits it
- Change: Move âhide-if-no-jsâ class up into link container classes (added if necessary) so link-adjacent text can be hidden as well
- New: Add ARIA attributes to improve accessibility
- Documentation:
- Change: Note compatibility through WP 6.6+
- Change: Update copyright date (2024)
- Change: Reduce number of âTagsâ from
readme.txt
- Change: Update screenshots
- Change: Tweak text formatting in
README.md
- Internals:
- Change: Add ELLIPSIS constant for ellipsis string and use it rather than harcoding string in various places
- Change: Prevent translations from containing unintended markup
- Change: Explicitly assign an array key to the added comment row action links
- Change: Define a version number when registering the styles
- Change: Bail earlier in functions when possible
- Change: Prevent unnecessary tabbed whitespace output
- Packaging/development:
- Change: Remove development and testing-related files from release packaging
- New: Add
.gitignore
file - Unit tests:
- Allow tests to run against current versions of WordPress
- New: Add
composer.json
for PHPUnit Polyfill dependency - Hardening: Prevent direct web access to
bootstrap.php
- Change: In bootstrap, store path to plugin directory in a constant
- Change: Prevent PHP warnings due to missing core-related generated files
- New: Add a potential TODO item
2.8.2 (2021-09-16)
- Change: Note compatibility through WP 5.8+
- Unit tests:
- Change: Restructure unit test directories
- Change: Move
phpunit/
intotests/
- Change: Move
phpunit/bin
intotests/
- Change: Move
- Change: Remove âtest-â prefix from unit test file
- Change: In bootstrap, store path to plugin file constant
- Change: In bootstrap, add backcompat for PHPUnit pre-v6.0
- Change: Restructure unit test directories
2.8.1 (2021-04-10)
- Change: Escape text used in markup attributes (hardening)
- Change: Note compatibility through WP 5.7+
- Change: Update copyright date (2021)
Full changelog is available in CHANGELOG.md.