Release 1.22

About

This is one of the biggest release of ComboStrap so far.

we have introduced an unique id for each page that permits:
- a better integration with the database and external application
- to offer permanent page url
the url manager has been renamed to router because it's what it does:
- it will route the request of your website or even deny them if
- it will now redirect all requests to the unique page url
the new metamanager permits to change the metadata via a form, no need to update manually the frontmatter
the quality monitoring message has moved to the railbar
and on the top of cherry cake as we don't want to move the focus from the current page, we have put the backlinks action in a modal.

And a lot more. See below for the whole details.

Update

We don't publish new release when they have not been tested by our key clients. Unfortunately, some users have seen it and have published it on Dokuwiki on their own. We are sorry for the inconvenience.

The last version is the 1.22.1 that corrects bug found during the production phase test.

The most well severe bug are:

crash when a page is created because of a missing page id (null error because sqlite returns an empty string and not null)
the page image was deleted from the frontmatter if enabled when the meta manager was used.

Action

You need to update the index with the search index manager
If you want to have the canonical path reported in place of the page path in the google analytics metrics, you should enable it.

List of changes

New

The home page attribute is_home in order to be able to select the home pages within page sql
The enhanced link wizard to search also on path, title, heading and name of a page.
Page SQL can now return backlink pages
references between pages (ie link and backlink) are now replicated in the database
The grid layout can now be used within an template iterator
description is now loaded into the database
Added microsoft codicon, ibm carbon and logos as icon library
Added a page on the internal search engine. See Internal Search Engine
Lockfile protection for the move plugin. When a move goes wrong, a lock file may stay in the data directory. If the lock file age is bigger than 5 minutes.
- We cancel any move
- We send a message
A language region will be determined from the server if not set.
Every page gets now a generated unique page id
The metadata viewer window. A window that shows all raw metadata known by your installation for a specific page.
The page alias have migrated into a table with the page_id as foreign key.
The permalink component permits to add a permalink to a page.
The page id is now the real permalink that performs a permanent redirection.
Bat Bot Scanning protection with shadow banning against well-known path.
The canonical path can be used instead of the page path for Google Analytics
We have created a dedicated page for the app name
The page url may be now permanent
The url manager is now known as the router and performs now better SEO redirection.
The slug metadata that can be used to create custom page url
We support now a migration from the plugin description. (ie the description is read but not written back)
You can set Keywords (because this was asked gently)
The page cache expiration frequency can be managed in the metadata manager
In the cache tab of the metadata manager, you can see now the cache hits of the slot of a page.
The dynamic quality monitoring is now a rail action. The writer will not see them at the top of the editor but in the railbar.
The search box is now based on Bootstrap DropDown and Popper for the placement. No need of the Dokuwiki Javascript bundle
The backlink action item is now a modal. You don't need to change of context and you stay on the actual page.

Deprecated

The frontmatter can still be used to enter metadata but the metadata manager is the recommended way.
The autofrontmatter feature has been deleted (due to the advent of the metadata manager.
With the advent of the metadata viewer window,
- the metadata does not need to be show in the editor and therefore the enableMetadataViewerWhenEditing configuration became obsolete and was deprecated.
- the special organization field has been deprecated. You should use now the json-ld field instead
The dokuwiki link class syntax has been dropped. The styling follows completely bootstrap except for Interwiki that requires a background styling for the icons.
The cache syntax component has been deprecated for the cache page expiration frequency metadata

Improvement

The data synchronization process is now treated as a real replication and got a date_synchronization and a universal id. The synchronization is now also based on the database version file.
the replication table ANALYTICS_TO_REFRESH has been renamed to EVENTS_QUEUE and an introduce asynchronous event functionality.
the frontmatter metadata are replicated directly to avoid inconsistency with page sql
The google json-ld supports now a full json-ld value. It's easier to valid it with the playground for the user.
The lock file created by the move plugin is now checked for every parse. It was only checked for page move and was purging page automatically each time making the site really slow.
The side slots cache management removes the cache only when one of the description attributes is updated (ie name, title, h1, description)
The page title for a web page has been enhanced with the namespace name and website name
The disqus identifier is now the page id by default.
The railroad diagram library is now served as resource with the no-transform attribute and will then not be transformed by a proxy.

Changes

The acronym / name of a icon library follows the library name of the iconify search engine. Therefore:
- for bootstrap, bs is now bi
- for material design, md is now mdi
To support the old icon library, the icons are not moved to the new directory.
The country metadata is now known as the language region to be more accurate as the region is often but not always a country.
The buster key has been changed to tseed to be in line with dokuwiki.
The best end page name redirection algorithm will create an redirect alias if the score is bigger than 2. This behavior can be disabled with the BestEndPageMinimalScoreForAliasCreation configuration.
The url manager is now known as the router to reflect the fact that it routes request to the correct page. This is due to the new permanent url and ban features.
The hierarchical breadcrumb uses now the page name in place of the title (Sort of bug)
Because of the autocompletion for the search box, Popper was needed and strap template now does not use the Bootstrap bundle but includes bootstrap and popper. No changes should be seen expected the fact that popper is now available in the global scope

Bug

After a change in the svg optimization, the svg shown will not refresh. Cause: The static cache buster was using the time of the original SVG file and not from the optimized file.
Not able to navigate to an heading from a link fragment for a internal link. Bug: the fragment was not qualified as fully section id (letting spaces in it)
The first rendering of a SVG would be empty. The cause root was that the buster calculation of the static cache would close the rendering of the svg and the src would set not be added. Resolution: we make a difference between request and response attribute and we have added an error message when the tag attributes are finalized twice.
The svg cache was not dependent on its optimization configuration.
The new date format was not applied on the published date causing a not valid date error message.
A page move would create two pages in the database. The move is now automatically replicated making it consistent.
Bug: The media statistics was crashing the page because it was asking the image and not the media file on third media such as video, pdf, …
lazy load on small raster image was showing a broken image at page load because the placeholder was not set.
bug: outline numbering was not reset for the heading level 3
facebook: the mime type of the image was returning only the first letter of the mime (A refactoring has modified the mime type to a string in place of an array and as php allows to take the first element of string (ie a letter), no error was reported) - A test has been added.
The redirection message was not shown when the redirect to search engine was performed.
footnotes styling were missing
The diff panel had no styling.
If there was a point in a page path, the default page name was deleting all character after this point thinking that it was an extension.
The configuration headingWikiEnable was not in the configuration panel.