Differences

This shows you the differences between two versions of the page.

--- plugin:metadisplay [2021-11-25 12:51] – old revision restored (2021-11-25 12:49) turnermm
+++ plugin:metadisplay [2023-10-31 00:33] (current) – Klap-in
@@ Line 2: / Line 2: @@
 ---- plugin ----
-description: provides an administration app that reads and displays meta files in table format; can also be used from the command line
+description: provides an administration app that searches meta files for metadata and displays results in table format; can also be used from the command line
 author     : Myron Turner
 email      : turnermm02@shaw.ca
 type       : admin
-lastupdate : 2021-11-21
+lastupdate : 2021-12-09
-compatible : greebo, hogfather
+compatible : Greebo, Hogfather
 depends    :
 conflicts  :
 similar    :
-tags       :
+tags       : metadata, list
-downloadurl:  http://github.com/turnermm/metadisplay/zipball/stable
+downloadurl:  https://github.com/turnermm/metadisplay/archive/refs/heads/master.zip
-bugtracker :  http://github.com/turnermm/metadisplay/issues
+bugtracker :  https://github.com/turnermm/metadisplay/issues
-sourcerepo :   http://github.com/turnermm/metadisplay/
+sourcerepo :   https://github.com/turnermm/metadisplay/
 donationurl:
@@ Line 32: / Line 32: @@
 === Description Field ===
  It can  search the description fields for pages containing specified terms. However it has to be kept in mind that the description field is stripped down to a ''raw text abstract (250 to 500 chars) of the page and the table of contents'' and the table of contents. See the description of the [[devel:metadata#data_structure|metadata data structure]].
-=== Links and Media ===
-Currently it can search pages which which contain links and media
 === Additional Search Fields ===
-As the plugin develops, it will add additional search fields
+  * Created by (user)
+  * Contributors
+  * Links
+  * Media
+  * Earlier or later than Created date
+  * Earlier or later than last Modfied date
+You can do a "fuzzy" search in any search field except for the Contributors field.  The "fuzzy" search is minimal. It is case insensitive and compensates for vowel errors. And some of these, like the dates, can be used in combination with one another.
+For the structure of the meta files and the data contained in them, see: [[devel:metadata|Metadata Storage]]
+==== Limitations ====
+The search does not use a database. It is essentially brute force and has not been tested against very large sites.
+But for other sites it can be very fast.
 ==== Command Line ====
@@ Line 51: / Line 79: @@
    php plugin.php metadisplay [-h] [--no-colors]  [--loglevel ] [[-n --namespace|.] [[-p -page] [-e --exact ]]]
     [[-b --before|-a --after] timestamp -d -dtype [modified|created]] [[-s --search|-f --fuzzy] [search-term]]
-    -c --cmdL
+    [-l --ltype contrib|creator]] -c --cmdL
    timestamp can be timestamp or numerical date of the form: Year-Month-Day
@@ Line 75: / Line 103: @@
    -d, --dtype                             sets whether file's timestamp is read from "created" or "modified" field
+   -l, --ltype                             set to search type: link, media, creator, contrib (contrib =
+   -                                                     contributor)
    -h, --help                              Display this help screen and exit immediately.
@@ Line 86: / Line 117: @@
 ==== How-To ====
 The above options can be used when working on the command line as described under [[#usage]] above.  The administration application also uses these options and implements them for you.