From c110e1d8b3059e8c8bfd981d18826a74db83d504 Mon Sep 17 00:00:00 2001
From: Matthieu Marcillaud <marcimat@rezo.net>
Date: Mon, 10 Jul 2023 13:19:42 +0200
Subject: [PATCH] deprecate: Fonction/filtre abs_url

Utiliser liens_absolus ou url_absolue
---
 CHANGELOG.md                |  1 +
 UPGRADE_5.0.md              | 27 +++++++++++++++++++++++++++
 ecrire/inc/filtres_mini.php |  3 +++
 3 files changed, 31 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index fb7307386e..8eff043516 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 c126a641d5..d8227cf83c 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 bef39cb7e8..b60ac7de70 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 {
-- 
GitLab