doc: add phpDocumentor configuration

See:
- https://phpdoc.org/
- https://docs.phpdoc.org/references/configuration.html
- https://github.com/phpDocumentor/phpDocumentor2

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

Merge pull request #1248 from virtualtam/refactor/namespacing

Ensure all PHP classes are properly namespaced

Optimize and cleanup imports

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

API: update test regexes to comply with PCRE2

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

composer: add and document optional PHP extensions

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: add plugin tests to \Shaarli\Plugin\[...]

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Plugin\PluginManager

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Netscape\NetscapeBookmarkUtils

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Router

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\ApplicationUtils

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Updater

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: add curl-ext to suggested dependencies

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: move LinkUtils along \Shaarli\Bookmark classes

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Bookmark\LinkFilter

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Bookmark\LinkDB

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\FileUtils

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Render\{PageBuilder,ThemeUtils}

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: move HTTP utilities along \Shaarli\Http\ classes

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Http\Url

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Http\Base64Url

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Feed\{Cache,CachedPage,FeedBuilder}

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\Exceptions\IOException

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

namespacing: \Shaarli\History

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

Merge pull request #1233 from shaarli/doc-fix-homepage-icon

doc: fix homepage icon

Merge pull request #1251 from shaarli/doc-update-php-compat

doc: update PHP compatibility table

doc: fix homepage icon
The icon did not display properly on https://shaarli.readthedocs.io/en/master/

doc: update PHP compatibility table

Ref https://github.com/shaarli/Shaarli/issues/1249

Merge pull request #1234 from virtualtam/lint

Setup PHPCS and cleanup linter configuration

lint: fix line-length warnings

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

lint: apply phpcbf to tests/

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

lint: apply phpcbf to index.php

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

lint: apply phpcbf to plugins/

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

lint: apply phpcbf to application/

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

lint: setup PHPCS for PSR-1 and PSR-2

Relates to https://github.com/shaarli/Shaarli/issues/95

See:
- https://github.com/squizlabs/PHP_CodeSniffer
- https://github.com/squizlabs/PHP_CodeSniffer/blob/master/phpcs.xml.dist
- https://www.php-fig.org/psr/psr-1/
- https://www.php-fig.org/psr/psr-2/

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

lint: remove unused tools

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

Merge pull request #1247 from llune/patch-5

add label to form - accessibility issue

Merge pull request #1246 from llune/patch-4

fix translation string

add label to form - accessibility issue

Don't use placeholder instead of label for form input.

fix translation string

Merge pull request #1236 from bisherbas/patch-1

Update session start condition

Update session start condition

Recommended method for PHP >= 5.4.0 as seen here https://stackoverflow.com/questions/6249707/check-if-php-session-has-already-started

Per https://shaarli.readthedocs.io/en/master/Server-configuration/ Shaarli supports PHP >= 5.6

Merge pull request #1235 from ilesinge/patch-2

Dead link on dead link detector tool

Dead link on dead link detector tool

Author's repo moved to Framagit

Merge pull request #1230 from virtualtam/composer/netscape-parser

Composer: bump netscape-bookmark-parser to 2.1

Merge pull request #1232 from shaarli/doc-rm-firefox-share

remove firefox share documentation

Merge pull request #1221 from nodiscc/doc-refactor-index-features2

doc: refactor documentation homepage

remove firefox share documentation
Firefox Share integration has been removed in https://github.com/shaarli/Shaarli/pull/1026
Firefox Share is not available anymore in any ESR/release versions of Firefox

Merge pull request #1231 from shaarli/revert-1220-url-filter

Revert part of #1220

Revert part of #1220
Fixes #1177
The `url` template filter is [only supported in Mkdocs 1.0+](https://github.com/mkdocs/mkdocs/blob/master/docs/about/release-notes.md#internal-refactor-of-pages-files-and-navigation)
Readthedocs.org uses Mkdocs `0.17.3 ` while `make htmldoc` fetches the [latest version from pypi](https://pypi.org/project/mkdocs/) which is `1.0.4`.
Following https://github.com/shaarli/Shaarli/pull/1220, building the docs fails with https://readthedocs.org/projects/shaarli/builds/7886340/

Composer: bump netscape-bookmark-parser to 2.1

Relates to https://github.com/shaarli/Shaarli/issues/1227

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

Merge pull request #1205 from ArthurHoaro/feature/opengraph

Add OpenGraph meta tags on permalink page

Merge pull request #1208 from ArthurHoaro/feature/select-all

Add a button to toggle all checkboxes of displayed links

Merge pull request #1211 from ArthurHoaro/hotfix/img-request

Fix a bug making thumbnail to request the current page

Merge pull request #1212 from ArthurHoaro/hotfix/hashtag-md-escape

Fix hashtags with markdown escape enabled

Merge pull request #1144 from ArthurHoaro/feature/sticky

Add a button to set links as sticky

Sticky feature - Add translation and display for logged out users

Add a button to set links as sticky

Meaning that they always appear on top of all links

Fixes #186

Merge pull request #1220 from nodiscc/doc-robots-noindex-nofollow

add "noindex, nofollow" HTML robots meta-tag to documentation pages

Merge pull request #1207 from ArthurHoaro/feature/cors

Add CORS headers to REST API responses

Merge pull request #1215 from ArthurHoaro/hotfix/tag-deletion

Fix a JS bug preventing AJAX tag deletion to work

Merge pull request #1213 from ArthurHoaro/plugins/isso-icon

Isso plugin: add an icon in linklist if enabled

doc: server config: basic usage of robots.txt/HTML robots meta-tag/crawler control mechanisms

add "noindex, nofollow" HTML robots meta-tag to documentation pages
 - Customize the "readthedocs" mkdocs theme: https://www.mkdocs.org/user-guide/styling-your-docs/#customizing-a-theme
 - Adds a '<meta name="robots" content="noindex, nofollow">' HTML tag on each page
 - Do not include robots directive on readthedocs.org, only in local builds

documentation: refactor documentation homepage

- simplify/organize feature list and contributing section
- move bug reporting/contact information to Contributing section
- unclutter

Ref https://github.com/shaarli/Shaarli/issues/1148#issuecomment-397871451 and https://github.com/shaarli/Shaarli/issues/598

Fix a JS bug preventing AJAX tag deletion to work

Fixes #1214

Isso plugin: add an icon in linklist if enabled

Fixes #1075

Fix hashtags with markdown escape enabled

They're now transformed to markdown syntax links before processing them through Parsedown.

Fixes #1210

Fix a bug making thumbnail to request the current page

Merge pull request #1209 from ArthurHoaro/hotfix/history-delete

History: fix a bug on bulk deletion where only one deletion were regi…

History: fix a bug on bulk deletion where only one deletion were registred

Add a button to toggle all checkboxes of displayed links

Related to #1160

Merge pull request #1206 from ArthurHoaro/hotfix/search-input-size

Fix input size for dropdown search form

Add CORS headers to REST API responses

Fixes #1174

Add OpenGraph meta tags on permalink page

Includes:
  - og:title
  - og:type -> article
  - og:image -> if there is a thumbnail
  - og:url -> permalink
  - og:description -> first 300 chars of raw description
  - article:published_time
  - article:modified_time
  - article:tag -> one OG meta tag for each shaare tag

Fixes #258

Fix input size for dropdown search form

Merge pull request #1193 from llune/patch-1

Update French translation

badge

CHANGELOG

Merge pull request #1204 from ArthurHoaro/hotfix/docker-build-failure

Fix docker build

Fix docker build

WT has php-gd as a requirement, which isn't available in composer docker image

Badge

Merge pull request #1203 from ArthurHoaro/changelog

CHANGELOG

Update AUTHORS

Signed-off-by: ArthurHoaro <arthur@hoa.ro>

CHANGELOG

Merge pull request #1202 from ArthurHoaro/composer

Upgrade composer - web-thumbnailer v1.3.0

Merge pull request #1200 from ArthurHoaro/hotfix/htaccess-version

Use version condition in the root .htaccess

Merge pull request #1199 from ArthurHoaro/hotfix/thumbnails-edit-link

Fix issue 'You are not authorized to add a link' with thumbnails enabled

Upgrade composer - web-thumbnailer v1.3.0

Merge pull request #1195 from llune/patch-3

Delete redundant titles

Use version condition in the root .htaccess

Related to #1196

Fix issue 'You are not authorized to add a link' with thumbnails enabled

Do not try to alter the datastore by updating thumbnails if the user isn't logged in.

Also, do not enable thumbnails if PHP GD extension is not installed/loaded

Merge pull request #1194 from llune/patch-2

empty alt on logo image

Delete redundant titles

Redundant titles are an accessibility issue and should be avoided.

See : https://accessibilitytips.com/2008/04/14/avoiding-redundant-title-attributes/

alt should be empty

empty alt on logo image

The alt does not provide any useful information for screenreader users. It just adds noise.

update translation

fix boutton

Maj French translation

Merge pull request #1191 from ArthurHoaro/hotfix/daily-thumb

Fix fatal error on daily page: use new thumbnail system

Fix fatal error on daily page: use new thumbnail system

Also fix:

  * include the login manager in the daily RSS feed function
  * remove redirector setting in the vintage theme

Fixes #1190