deprecate: Fonction/filtre abs_url

Utiliser liens_absolus ou url_absolue

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}`

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
 

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 {