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.

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.