nieuws: navigation links in common aside container

issue: metadata list in aside container

Better semantics, benefits from common aside styling.

article: ignore placeholders before teaser paragraph

article: find teaser paragraph from variable offset

Simplify matching by starting at optional first </h2>.
No longer ignores (short) preceding titles such as on Lijtweg home;
more reliable otherwise.

page: restrict security policy of base-src

head: indicate explicit og:type of website

Include just to allow page overrides, such as "article" for nieuws pages
(might affect Facebook, but seems a minor and mostly useless distinction).
At least silences Dareboost warnings about required Open Graph properties.

head: include canonical location in og:url

Does not (yet) account for all aliases, but at least provides a good
reference to the requested page.

page: extend teaser range of fallback paragraph

Arbitrarily increase allowed separation to 512 bytes, as Lijtweg index page
introduction recently moved beyond 256 because of longer image paths.

page: declare minimal security policy header

Define current data usage to provide some protection from XSS attacks.
Allow for remaining scripts and images (editor script, gallery, some onclick
actions in user forms, inline svg) to be improved at a later time.

page: disallow frame ancestors to prevent clickjacking

Security policy recommended by Dareboost, to stop potential malicious page
embedding.  Support should be decent (enough), so do not bother with an
equivalent X-Frame-Options directive for compatibility.

thumb: strip metadata and chroma

Decreased colour quality recommended by Google PageSpeed:
<https://developers.google.com/speed/docs/insights/OptimizeImages>

thumb: decrease preferred quality to 85%

Better trade-off, also recommended by PageSpeed.

thumb: prefer progressive jpeg encoding

Intermediate rendering for faster results, and overall smaller file sizes
similar (if not identical) to jpegtran -optimize or PageSpeed.

page: reenclose template contents in static container

Fix editing of new pages since v4.2-24-ged38c6a767 (2020-02-04)
[page: article method to find handler code].

issue: match image replies for metadata

Database paragraphs not cleaned by editor lack preceding newline.

login: target page in description and image metadata

login: run handler of pending melding page

Run script to get dynamic page metadata.  Most wanted for issues (otherwise
inaccessible since move to database), considered mostly safe to execute.
Not a generic solution for other code which could exit.

login: redirection message if pending page

Assume ?goto page required authorisation.

page: article method to find handler code

page: separate method to load page contents

reply: ignore empty image uploads

Fix invalid image appended for UPLOAD_ERR_NO_FILE.

reply: accept html input from admins

Forgo html formatting if text starts with an element such as <p>.
Restricted for safety since it's not validated.  Intermediate solution to
support rich contents (wysiwyg editor can be added later for accessibility).

reply: accept image uploads with messages

issue: move photo icon before replies

Most common parts last for more stable appearance.

login/post: require user to access

Redirect to login to avoid incomprehensible error message.

Reported-by: Heleen Terlouw <heleen.terlouw.2910@gmail.com>

issue: derive page metadata from row data

page: fix titleless article teaser fallback

Broken since commit v4.0-28-gb3aec6cf1c (2019-11-09)
[page: replace output caching by article object].

thumb: delete subsequent animation frames

Convert animated GIFs and accidental video to still frame.

page: fix variable dependencies in error headers

Editor checks broken in page.inc.php being called from fail() function.

issue: common icon glyphs for improved fallback

Irrelevant after styling, but improves compatibility if unstyled:
- RIGHT SPEECH BUBBLE is a common emoji available on at least android;
- CAMERA is more specific for the expected usage, and similar to other
  popular sites such as Twitter.

issue: unicode characters of indicator icons

Replace ASCII placeholders by semantic equivalents, which can be styled by
custom fonts to maintain full client compatibility.

issue: code cleanup breaking up row attributes

Identical results using separate, more maintainable statements.

issue: indicate image presence in overview

Advertise uploads as they are proverbially worth more than text replies.

reply: convert CR in line breaks

Store submitted network/dos newlines as expected unix LF.

issue: do not immediately close inserted rows

Database fix applied earlier.

page: convert error messages to html strings

Exception objects need to be converted to strings for usage as placeholders,
and while at it, xml characters should be escaped for proper display.

page: reload error page within fail handler

Catch errors during display (such as an invalid placeholder value fixed in
the next commit) instead of ignoring subsequent displays causing empty
output.

page: capture multiline titles in article contents

Fix recent page (doc/alv/2019-11-26/cv) containing subtitle.

doclist: background width to end line at last item

Assuming stylesheet draws a line by background-image, calculate its size to
target the earliest item.

doclist: sublists of multiple dates grouped by year

doclist: code cleanup and preparation

doclist: timeline styling to position links by age

Calculate absolute "left" position based on average date lengths,
to be optionally used by the site's stylesheet.

issue: populate ticket data before reply include

Reorder in commit v4.1-34-gc83e7f0379 (2019-11-25) [issue: include replies
before issue retrieval] breaks admin features due to missing $Issue.
Update row data on update instead.

page: filter login/logout classes on any html element

Needed on <ul>, but extend to cover any future usage.

issue: include replies before issue retrieval

Load reply data before row query to reflect changes directly.

issue: wrap items to allow containment

Fix contents from appearing in next <li> with lower screen width.

Similar to column lists in commit v3.4-0-g72d8db8c87 (2018-07-08)
[login/list: wrap each item to allow containment].

issue: metadata in sidebar container

Separate list of global summary information, allowing a more hidden (aside)
styling keeping focus on discussion and clarifying repetitions (most items
are also represented as changes).

upload: replace double line breaks by paragraphs in text input

upload: common function to parse user text input

Move duplicate code from issue and reply pages.

reply: omit empty messages like issue page

Copy recent update in formatting.

page: restore meta tags for editors

auth: append login to formatted user names

foto: increase thumbnail height for exceptional rows

Even with the configured maximum of 200*1.25=250px, resulting sizes appear
to regularly exceed that, with anything up to 262px being quite common and
easily reproducible (in Lijtweg historisch).

foto: keep static images of height 250

Drop dynamic source replacement to match actual client sizes, as the quality
loss from downsizing a _larger_ image is minimal.

Originally introduced in lijtweg commit v2.5-7-gcd93e774e6 (2017-10-11)
[foto: replace justified thumbnails by height-optimised versions]
with visible improvements probably due to using the target size of 200px
without adjusting for up to 1.25x enlargement to fit.

Testing originals of 250px on modern browsers with (bilinear) rescaling
is hard to distinguish (not significantly more blurry) and depends on only
a single thumbnail resolution to be created for significantly reduced
resource requirements.  May be slightly larger on average, but likely much
smaller without reloads and considering caching opportunities.

issue: styling class on closed rows

Link tag does not cover metadata.  Keep strike-through for compatibility,
but with equivalent <s> as <strike> has been deprecated in HTML5.

issue: feed subpage for atom xml formatting

Feature of news articles lost during database transition.

Include adapted from nieuws/feed/index.php for different object structure
(to be merged again later if possible).

login/commits: escape html characters in commit messages

widget/contact: accept non-word characters in sender email addresses

Allow any remotely valid address, including <hans.verlinden@planet.nl>.

reply: list attribute changes for each row

reply: identify textual journal columns

issue: count number of replies in overview

reply: omit header from mandatory output

Can be prepended manually if wanted.

issue: inline ticket body like replies

issue: display assignments in overview

issue: resolve author logins to full names

issue: select restricted by current page

Allow setup of multiple distinct categories.

issue: record row changes in journal

issue: admin option to close or reopen

issue: assignment text field for admins

reply: share parent data from issue page

Provide easy access to selected metadata.

reply: set method to abstract update queries

Extend insert, renamed to generic "set", to allow updates using the same
syntax with an additional select parameter.

issue: database insert method to keep array values

Feature to apply literal SQL with optional arguments, stolen from other
projects modeled after DBIx::Simple.

issue: closed at bottom, option ?open to exclude

issue: display ticket creation date

issue: order by last update, changed on reply

Initial value determined by:

UPDATE issues SET updated = greatest(created, closed, (
SELECT max(created) FROM comments WHERE page = issues.link
));

issue: append and ignore page titles in links

Preserve names of replaced files, and improve recognition of sent targets
as well as seo score.

issue: track messages in database

Replace file storage by PostgreSQL table, similar to comments in commit
v4.0-21-g0cc6251412 (2019-10-27) [nieuws/replies: read contents from database].

Existing files are imported similar to earlier comments:

ls melding/2*/*.html | perl -MFile::Slurp -lnE ' #/
my ($page, $date, $name) = split m{/};
$name =~ s/(\d+-\d+)-// and $date .= "-$1";
my $closed = qx(stat -c%y "$page/.tags/opgelost/$date-$name" 2>/dev/null);
chomp $closed;
$name =~ s/\.html$//;
my $html = read_file($_);
$html =~ s{<h2>(.*?)</h2>\n+}{}; my $title = $1;
chomp, s/\\\K/\\/g, s/\n/\\n/g, s/\t/\\t/g for $html;
say join "\t", $page, $date, $name, $title, $html, $closed || "\\N";
' | psql lijtweg -c 'COPY issues (page, created, link, subject, body, closed) FROM STDIN'

Afterwards, the following queries can be executed to convert and clean up
these imported rows further:

-- rename issue references to new page ids
UPDATE comments c SET page = (SELECT coalesce((SELECT page||'/'||id
FROM issues WHERE c.page LIKE page || '/%-' || link), c.page));

-- move authorship contents to dedicated column
SELECT id, regexp_matches(body, '<p class="right">(?:Ingediend door |<em>)?([^<]*)')
FROM issues WHERE body ~ 'right';
UPDATE issues SET author = 'cees' WHERE body ~ '<p class="right">.*Cees';
UPDATE issues SET author = '301' WHERE body ~ '<p class="right">.*de Roos';
UPDATE issues SET body = regexp_replace(body, E'\n+<p class="right">.*</p>$', '')
WHERE body ~ 'right';

reply: restrict submission form to users

Assumed as much on insert.

nieuws: authorise admins by edit subpermissions

Treat news maintenance like any other edit location.

login/edit: move admin block to distinct widget

login/edit: user override in page code

login/edit: admin event dates (creation, setup, visit)

edit/page: keep page named after existing directory

Allow either subdir.html or subdir/index.html, preventing edit from creating
conforming duplicates.

Reported-by: Arie van Marion

page: silence object warnings on missing pages

page: replace output caching by article object

nieuws: avoid invalid date access for missing articles

Broken since page objects introduced in commit v3.9-11-g234326791b
(2019-06-28) [page: promote news article class to represent all pages].

reply: setup database to fetch objects

Avoid repetition on each fetch in upcoming usage.

nieuws: rename nieuws/replies widget to generic reply

Can be placed on any page (such as upcoming issues), not specific to nieuws.

widget/contact: current user overrides login, email fallback

nieuws/replies: insert method to add database rows

Minimal database abstraction for code maintainability
(feature similar to perl DBIx::Simple).

nieuws/replies: database class with query method

Code cleanup preparing for more extensive database support
(where default php is somewhat lacking).

nieuws/replies: read contents from database

Replace file storage by a PostgreSQL table.  Resign to the additional
dependency for this kind of social feature since it's much more appropriate
(especially with upcoming extensions), and optional similar to external
comment services.

Identical results after importing existing files:

ls melding/2*/*/*.html | perl -MFile::Slurp -lnE '
my ($page, $meta) = m{(.*)/(.*)};
my ($time, $author) = split /[:.]/, $meta;
$time .= "00" while length($time) < 14;
$time =~ s/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})/$1-$2-$3 $4:$5:/g;
my $html = read_file($_);
chomp, s/\\\K/\\/g, s/\n/\\n/g, s/\t/\\t/g for $html;
say join "\t", $page, $author, $time, $html;
' | psql -c 'COPY comments (page, author, created, message) FROM STDIN'

auth: admin edit permissions for page (sub)directories

Allow edit parameters to match parent directories; for example "edit doc"
to maintain all but only documents.

auth: admin subpermission check for edit pages

Check for specific "edit $path" rights in addition to full "edit",
allowing for partial access.

sitemap: skip subdirectories containing .gitignore

Assume html files stored in (partially) untracked directories are not meant
for public distribution.  Fixes unintended inclusion of profile/ pages and
archived documents in data/, and avoids a costly search in thumb/.

login/post: ignore ?login override for non user admins

Confidential data was not secure from people who acquired these urls.

login/edit: password generation for user admins

Option to reset users of Lijtweg.

login/edit: allow setup form for missing users

Fix creation since validation added in commit v3.6-0-gd1fc7642f0
(2018-08-11) [login/emulate: request page as different user].

login/edit: reconfigure size attribute

Ignored since syntax change in commit v3.7-15-g1888ccc749 (2018-11-13)
[login/edit: generic setup of input attributes].

login/edit: remaining access from user object

Some optional code paths broken by commit v3.9-8-g882347cba8 (2019-06-28)
[auth: store global user metadata in User object].