Implementing TTRSS: Searching #124

New issue

Closed

opened 2017-11-20 00:16:38 -05:00 by jking · 0 comments

jking commented

2017-11-20 00:16:38 -05:00

Owner

The getHeadlines operation (see #83) allows for a search-string to be input to return fine-grained results. In the interests of time our original Tiny Tiny RSS implementation omits this, but it can and should be supported eventually---though possibly only after PostgreSQL and MySQL/MariaDB are supported.

The search syntax is described below:

Search Syntax

Search query consists of several keywords. If keyword starts with "-", it is considered a negative match. Several special keywords are available:

@{date} - match by date. For example, @yesterday or @2011-11-03. Please note that due to incomplete implementation, special date keywords like yesterday might not match all articles if user timezone is different from tt-rss internal timezone (UTC).
pub:{true,false} - match only published or unpublished articles
star:{true, false} - same, starred articles
unread:{true, false} - self explanatory (requires trunk as of 05.03.2015)
note:{true, false, sometext} - same, for articles having an attached note or matching the specified text
title:, author: - self explanatory

Pointless as it may be, you can combine the negative prefix with the special keywords: -star:true would essentially mean star:false.

The `getHeadlines` operation (see #83) allows for a search-string to be input to return fine-grained results. In the interests of time our original Tiny Tiny RSS implementation omits this, but it can and should be supported eventually---though possibly only after PostgreSQL and MySQL/MariaDB are supported. The search syntax is described below: Search Syntax ============= Search query consists of several keywords. If keyword starts with "-", it is considered a negative match. Several special keywords are available: * @{date} - match by date. For example, @yesterday or @2011-11-03. Please note that due to incomplete implementation, special date keywords like yesterday might not match all articles if user timezone is different from tt-rss internal timezone (UTC). * pub:{true,false} - match only published or unpublished articles * star:{true, false} - same, starred articles * unread:{true, false} - self explanatory (requires trunk as of 05.03.2015) * note:{true, false, sometext} - same, for articles having an attached note or matching the specified text * title:, author: - self explanatory Pointless as it may be, you can combine the negative prefix with the special keywords: -star:true would essentially mean star:false.