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].

widget/doclist: show hidden files to edit admins

Include private files as alternate options for editors.  Presence of html
still takes precedence, and extension formats are considered a last resort
and no longer include sizes.

sitemap.xml: calculate priority from path names

sitemap.xml: common protocol listing all pages

Minimal implementations of sitemap for make benefit glorious engines of
search.

page: include partial templates from *.inc.html

Rename system files to be distinguishable from public pages.

widget/sitemap: move find code to global PageSearch class

widget/sitemap: linkref part to format a single page

login/edit: admin links to doc/post user pages

login/post: prepend print button

login/post: handler renamed from emulate page

login/emulate: serve subpages instead of redirects

login/emulate: user override from optional ?login parameter

Replace mandatory path argument.

auth: admin permissions per function

Replace generic .admin files by lines of right identifiers.
Check specific rights for: edit, user, site, news, foto.

thumb: jpeg content type for cached images

Generated files should be image/jpeg regardless of extension.

thumb: omit immutable caching for derived results

Even if the originals are treated as immutable, prefer an option to update
conversions since options may be changed later to improve quality.

thumb: indicate 1 month caching of generated output

Same header as set by Apache for static results.

thumb: flatten transparent images to white background

Ensure consistent background for some SVG and PNG originals.

thumb: ensure exception message in X-Error header

Multiline convert warnings would be ignored; the first line should suffice.
Include the expected header regardless of fallback output.

page: strip metadata tags from article preface

Search html body top for all <meta /> html intended as page data, available from
object $meta, but not shown directly as contents.  Matches for description
were returned already as teaser, but not removed.  Similar overrides are now
considered for title and image methods as well.