From 4aa5c7f5efa1e2e990158e801cc0c852780f511e Mon Sep 17 00:00:00 2001
From: Xymph <Xymph@users.noreply.github.com>
Date: Thu, 20 Jul 2023 16:22:24 +0200
Subject: [PATCH] Add new method Wikimate::undelete()

---
 CHANGELOG.md |  1 +
 Wikimate.php | 41 ++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 41 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 24f2d81..0b49602 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ and [Keep a Changelog](http://keepachangelog.com/).
 
 - Added internal mechanism to handle version-dependent parameters of API modules ([#151])
 - Support version-dependent `deletetalk` parameter in `WikiPage::delete()` and `WikiFile::delete()` ([#152])
+- New method `Wikimate::undelete()` ([#153])
 
 ### Changed
 
diff --git a/Wikimate.php b/Wikimate.php
index 60c1fca..15c3add 100644
--- a/Wikimate.php
+++ b/Wikimate.php
@@ -362,6 +362,7 @@ protected function token($type = self::TOKEN_DEFAULT)
      * Current list of modules for which this mechanism is employed:
      * - {@link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Logout logout}
      * - {@link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Delete delete}
+     * - {@link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Undelete undelete}
      *
      * @return void
      * @link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Parameter_information
@@ -371,7 +372,7 @@ private function storeModuleParams()
         // Obtain parameter info for modules
         $details = array(
             'action' => 'paraminfo',
-            'modules' => 'logout|delete',
+            'modules' => 'logout|delete|undelete',
         );
 
         // Send the paraminfo request
@@ -707,6 +708,44 @@ public function delete($array)
         return $this->request($array, $headers, true);
     }
 
+    /**
+     * Performs an undelete query to the wiki API.
+     *
+     * @param   string         $name     The original name of the wiki page or file
+     * @param   string         $reason   Reason for the restore
+     * @param   boolean        $talktoo  True to restore talk page, if any;
+     *                                   false to leave talk page deleted (MW 1.39+)
+     * @return  array|boolean            Decoded JSON output from the wiki API
+     * @link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Undelete
+     */
+    public function undelete($name, $reason = null, $talktoo = true)
+    {
+        // Obtain default token first
+        if (($undeletetoken = $this->token()) === null) {
+            return false;
+        }
+
+        $headers = array(
+            'Content-Type' => "application/x-www-form-urlencoded"
+        );
+
+        // Set options from arguments
+        $array = array(
+            'action' => 'undelete',
+            'title' => $name,
+            'token' => $undeletetoken
+        );
+        if (!is_null($reason)) {
+            $array['reason'] = $reason;
+        }
+        // Check if undeletetalk parameter is supported (it is since MediaWiki v1.39)
+        if ($this->supportsModuleParam('undelete', 'undeletetalk') && $talktoo) {
+            $array['undeletetalk'] = $talktoo;
+        }
+
+        return $this->request($array, $headers, true);
+    }
+
     /**
      * Downloads data from the given URL.
      *