Changeset 1804181

Timestamp:

01/17/2018 02:52:31 AM (7 years ago)

Author:

JorgeAmVF

Message:

better-formed readme.txt file provided and update

Location:

ments/trunk

Files:

• ments.php (modified) (2 diffs)
• readme.txt (modified) (1 diff)

ments/trunk/ments.php

@@ -2 +2 @@
 /*
 * Plugin Name: autometa's MENTS
-* Description: It reproduces a comment list on pages or posts or portfolios or products simply via: [ments].
-* Version: 1.0
+* Description: It reproduces comment lists in pages, posts, portfolios or products simply via: [ments] and [recents].
+* Version: 2.0
 * Author: JorgeAmVF
 * Author URI: https://profiles.wordpress.org/jorgeamvf/
@@ -26 +26 @@
 */
 
-// [ments] = comment lists
-function autometa_ments($args, $comments){
-$comments = get_comments(array('order' => 'ASC', 'status' => 'approve'));
-wp_list_comments(array('walker' => new autometa_ments_Walker_Comment(), 'echo' => 1, 'per_page' => 0, 'type' => 'comment'), $comments);
- return wp_list_comments();
+// [ments] = comment list
+function autometa_comment_list( $args, $comments ) {
+    $comments = get_comments( array(
+        'order' => 'ASC',
+        'status' => 'approve'
+    ) );
+    $am_ments = '<span id="ments" class="autometa">' . wp_list_comments( array(
+        'walker' => new autometa_ments_Walker_Comment(),
+        'echo' => 1,
+        'per_page' => 0,
+        'type' => 'comment'
+    ),
+        $comments
+    ) . '</span>';
+    return wp_list_comments();
 }
-add_shortcode("ments","autometa_ments");
+add_shortcode( "ments", "autometa_comment_list" );
+
+// [recents] = recent list
+function autometa_recent_list( $args, $comments ) {
+    $comments = get_comments( array(
+        'order' => 'DESC',
+        'status' => 'approve'
+    ) );
+    $am_recents = '<span id="recents" class="autometa">' . wp_list_comments( array(
+        'walker' => new autometa_ments_Walker_Comment(),
+        'echo' => 1,
+        'per_page' => 3,
+        'reverse_top_level' => 0,
+        'type' => 'comment'),
+         $comments
+    ) . '</span>' ;
+    return $am_recents;
+}
+add_shortcode( "recents", "autometa_recent_list" );
 
 /**

ments/trunk/readme.txt

@@ -2 +2 @@
 Contributors: JorgeAmVF
 Donate link: https://quaestio.org/
-Tags: shortcode, automation, metadata, taxonomy, cloud, category, tag
+Tags: shortcode, automation, comment, comment list, list, recent comments, recent
 Requires at least: 2.8.0
-Tested up to: 4.8.1
+Tested up to: 4.9.2
 Stable Tag: trunk
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 
-It reproduces a list with all comments on pages, posts, portfolios and products simply via: [cats] and [tags] and [catag].
+It reproduces comment lists in pages, posts, portfolios or products simply via: `[ments]` and `[recents]`.
 == Description ==
  
 **autometa's MENTS** is a simple plugin that uses the following shortcodes:
 
-* *[ments]* = to reproduce a comment list mixing all comments from pages, posts, portfolios and products.
+* `[ments]`   = to reproduce all comments;
+* `[recents]` = to reproduce recents comments.
 
-**autometa's MENTS** is an element of **[autometa](https://wordpress.org/plugins/autometa/)** plugin set.
+**autometa's MENTS** is a standalone component of **[autometa](https://wordpress.org/plugins/autometa/)** shortcodes pack.
 
 == Installation ==
 
-1. Download it or install it to your plugin folder;
-2. Activate it from the plugin tab inside your dashboard;
-3. Write the following shortcode in text fields: **[ments]**.
+1. Install it from *Dashboard*/*Plugins*/*Add Plugins* or download it to your plugin folder;
+2. Activate it from *Dashboard*/*Plugins*/*Installed Plugins*;
+3. Write the following shortcodes in text fields: `[ments]`, `[recents]`.
 
 == Frequently Asked Questions ==
 
-= How does autometa's MENTS work? =
+= Plugin Features =
 
-**[autometa](https://wordpress.org/plugins/autometa/)** reproduces metadata information automatically via shorcodes in general, **autometa's MENTS** reproduces a comments list in special.
+**[autometa](https://wordpress.org/plugins/autometa/)** reproduces metadata information automatically via shorcodes in general, **autometa's MENTS** generates comment lists in special.
 
-= What is needed to use autometa's MENTS? =
+= How To =
 
-Just write the following shortcodes inside a text field and between brackets as usual: *[ments]*.
+Just write one or more of the following shortcodes inside a text field and between brackets as usual: `[ments]` and/or `[recents]`.
 
-= Which functions are used by autometa's MENTS? =
+= CSS Style Selectors =
 
-These: [`add_shortcode()`](https://codex.wordpress.org/Function_Reference/add_shortcode) and [`get_comments()`](https://codex.wordpress.org/Function_Reference/get_comments) and [`wp_list_comments()`](https://codex.wordpress.org/Function_Reference/wp_list_comments) and [`Walker`](https://codex.wordpress.org/Class_Reference/Walker) and [`get_comment_author_link()`](https://developer.wordpress.org/reference/functions/get_comment_author_link/) and [`get_comment_link()`](https://developer.wordpress.org/reference/functions/get_comment_link/) and [`get_the_title()`](https://developer.wordpress.org/reference/functions/get_the_title/).
+* `#ments`    = `[ments]` ID;
+* `#recents`  = `[recents]` ID;
+* `.autometa` = **autometa** class.
+
+= PHP Functions Reference =
+
+* [`add_shortcode()`](https://developer.wordpress.org/reference/functions/add_shortcode/)
+* [`get_comment_author_link()`](https://developer.wordpress.org/reference/functions/get_comment_author_link/)
+* [`get_comment_link()`](https://developer.wordpress.org/reference/functions/get_comment_link/)
+* [`get_comments()`](https://developer.wordpress.org/reference/functions/get_comments/)
+* [`get_the_title()`](https://developer.wordpress.org/reference/functions/get_the_title/)
+* [`Walker`](https://developer.wordpress.org/reference/classes/walker/)
+* [`wp_list_comments()`](https://developer.wordpress.org/reference/functions/wp_list_comments/)