2022-11-27 13:51:46 +00:00
|
|
|
# README
|
|
|
|
|
2023-08-06 22:51:49 +00:00
|
|
|
[![Release](https://img.shields.io/badge/release-1.9-a2cbe9.svg)](https://git.dotclear.watch/JcDenis/alias/releases)
|
|
|
|
[![Date](https://img.shields.io/badge/date-2023.08.06-c44d58.svg)](https://git.dotclear.watch/JcDenis/alias/releases)
|
|
|
|
[![Dotclear](https://img.shields.io/badge/dotclear-v2.27-137bbb.svg)](https://fr.dotclear.org/download)
|
|
|
|
[![Dotaddict](https://img.shields.io/badge/dotaddict-official-9ac123.svg)](https://plugins.dotaddict.org/dc2/details/alias)
|
|
|
|
[![License](https://img.shields.io/github/license/JcDenis/alias)](https://git.dotclear.watch/JcDenis/alias/blob/master/LICENSE)
|
2022-11-27 13:51:46 +00:00
|
|
|
|
|
|
|
## WHAT IS ALIAS ?
|
|
|
|
|
|
|
|
_alias_ is a plugin for the open-source
|
|
|
|
web publishing software called Dotclear.
|
|
|
|
|
|
|
|
This plugin creates public aliases of your blog's URLs.
|
|
|
|
|
|
|
|
## REQUIREMENTS
|
|
|
|
|
|
|
|
_alias_ requires:
|
|
|
|
|
2023-07-30 06:57:58 +00:00
|
|
|
* admin permissions for management
|
|
|
|
* Dotclear 2.27
|
|
|
|
* PHP 7.4+
|
2022-11-27 13:51:46 +00:00
|
|
|
|
|
|
|
## USAGE
|
|
|
|
|
|
|
|
First install _alias_, manualy from a zip package or from
|
|
|
|
Dotaddict repository. (See Dotclear's documentation to know how do this)
|
|
|
|
|
|
|
|
You can manage your aliases from menu ''Alias'' on admin dashboard sidebar.
|
|
|
|
|
2023-04-30 23:15:19 +00:00
|
|
|
## RULES
|
|
|
|
|
2023-04-30 23:22:24 +00:00
|
|
|
- Only blog URLs can be redirected.
|
|
|
|
- It can redirect a specific URL "plop" to another one "post/2023/04/24/my-post".
|
|
|
|
- It can redirect all URLs that content "plop" using alias "/plop/"
|
|
|
|
by replacing it by destination "post" into requesting URL. (Even if it's not at the begining of the URL!)
|
|
|
|
- It can not redirect an alias to another alias.
|
|
|
|
- It has priority on all ohters URLs handlers, so if you create an alias of an existing page,
|
2023-04-30 23:15:19 +00:00
|
|
|
the destination from plugin _alias_ will be used.
|
|
|
|
|
|
|
|
Keep in mind, plugin _alias_ loads all registered aliases to test them on each page load,
|
|
|
|
so more there are aliases, more page load is slow.
|
|
|
|
|
2022-11-27 13:51:46 +00:00
|
|
|
## LINKS
|
|
|
|
|
|
|
|
* License : [GNU GPL v2](https://www.gnu.org/licenses/old-licenses/lgpl-2.0.html)
|
2023-08-06 15:28:57 +00:00
|
|
|
* Source & contribution : [Gitea Page](https://git.dotclear.watch/JcDenis/alias) or [GitHub Page](https://github.com/JcDenis/alias)
|
|
|
|
* Packages & details: [Gitea Page](https://git.dotclear.watch/JcDenis/alias/releases) or [Dotaddict Page](https://plugins.dotaddict.org/dc2/details/alias)
|
2022-11-27 13:51:46 +00:00
|
|
|
|
|
|
|
## CONTRIBUTORS
|
|
|
|
|
|
|
|
* Olivier Meunier
|
|
|
|
* Franck-paul
|
|
|
|
* Jean-Christian Denis
|
|
|
|
|
2023-04-30 23:22:24 +00:00
|
|
|
You are welcome to contribute to this code.
|