diff --git a/CHANGELOG.md b/CHANGELOG.md index fb7307386e97c06f8825091e30b9e88c36617bc4..8eff04351608e1eeac5e3a4fb2a0049e6795695b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -25,6 +25,7 @@ ### Deprecated +- Filtre/fonction `abs_url`. Utiliser `url_absolue` ou `liens_absolus` selon. - Dans les fonctions `extraire_idiome` et `extraire_multi`, le 3è paramètre `$options` de type `bool` est déprécié. Utiliser un array `['echappe_span' => true]` - #5552 Constantes `_COOKIE_SECURE` et `_COOKIE_SECURE_LIST` (utiliser les options `secure` et/ou `httponly` de `spip_setcookie`) - #5565 Critère `{collecte}`. Utiliser `{collate}` diff --git a/UPGRADE_5.0.md b/UPGRADE_5.0.md index c126a641d5bee15be6ea886da558c42626260742..d8227cf83ccd3dd572e2994cf3feda4ac5ba4bc6 100644 --- a/UPGRADE_5.0.md +++ b/UPGRADE_5.0.md @@ -172,6 +172,33 @@ $hash = spip_sha256('mon contenu'); $hash = hash('sha256', 'mon contenu'); ``` +### Fonction `abs_url` (dépréciée en 5.0) + +Utiliser `url_absolue` ou `liens_absolus` selon. + +#### Avant + +```php +$texte = abs_url($texte); +$url = abs_url($url); +``` + +```spip +[(#TEXTE|abs_url)] +[(#URL_ARTICLE|abs_url)] +``` + +#### Après + +```php +$texte = liens_absolus($texte); +$url = url_absolue($url); +``` + +```spip +[(#TEXTE|liens_absolus)] +[(#URL_ARTICLE|url_absolue)] +``` # Suppressions des éléments dépréciés diff --git a/ecrire/inc/filtres_mini.php b/ecrire/inc/filtres_mini.php index bef39cb7e82aea91f84ae4b26b7dd3b985767936..b60ac7de701c39ea5d3d6f3fa01fa688445085c8 100644 --- a/ecrire/inc/filtres_mini.php +++ b/ecrire/inc/filtres_mini.php @@ -212,6 +212,8 @@ function liens_absolus($texte, $base = '') { * Transforme une URL ou des liens en URL ou liens absolus * * @filtre + * @deprecated 5.0 Uses `url_absolue` or `liens_absolus`. + * * @link https://www.spip.net/4128 * @global string $mode_abs_url Pour connaître le mode (url ou texte) * @@ -220,6 +222,7 @@ function liens_absolus($texte, $base = '') { * @return string texte ou URL (en absolus) **/ function abs_url($texte, $base = '') { + trigger_deprecation('spip', '5.0', sprintf('Using "%s" is deprecated. Use "%s" or "%s"', __FUNCTION__, 'url_absolue', 'liens_absolus')); if ($GLOBALS['mode_abs_url'] == 'url') { return url_absolue($texte, $base); } else {