" . \wp_kses_post($this->parseMarkdownToHtml($body)) . "
\n\n";
}
- return $changelog ?: 'No changelog available.';
+ return $changelog ?: $this->config->__("No changelog available.");
}
/**
* Get last updated date
*
- * @return string
+ * Fetches the publication date of the latest release from GitHub API.
+ *
+ * @return string Last updated date in Y-m-d format
+ *
+ * @since 1.0.0
*/
private function getLastUpdated(): string
{
$apiUrl = "https://api.github.com/repos/{$this->config->githubRepo}/releases/latest";
$response = \wp_remote_get($apiUrl, [
- 'timeout' => 15,
- 'headers' => [
- 'Accept' => 'application/vnd.github.v3+json',
- 'User-Agent' => 'WordPress/' . \get_bloginfo('version'),
- ],
+ "timeout" => 15,
+ "headers" => $this->getApiHeaders(),
]);
if (\is_wp_error($response) || 200 !== \wp_remote_retrieve_response_code($response)) {
- return date('Y-m-d');
+ return date("Y-m-d");
}
$body = \wp_remote_retrieve_body($response);
$data = json_decode($body, true);
- if (!isset($data['published_at'])) {
- return date('Y-m-d');
+ if (!isset($data["published_at"])) {
+ return date("Y-m-d");
}
- return date('Y-m-d', strtotime($data['published_at']));
+ return date("Y-m-d", strtotime($data["published_at"]));
}
/**
* Clear version cache after update
*
- * @param \WP_Upgrader $upgrader WP_Upgrader instance
- * @param array $data Array of update data
+ * @param WP_Upgrader $upgrader WP_Upgrader instance
+ * @param array $data Array of update data
*/
- public function clearVersionCache(\WP_Upgrader $upgrader, array $data): void
+ public function clearVersionCache(WP_Upgrader $upgrader, array $data): void
{
- if ($data['action'] === 'update' && $data['type'] === 'plugin') {
- if (isset($data['plugins']) && in_array($this->pluginSlug, $data['plugins'])) {
+ if ($data["action"] === "update" && $data["type"] === "plugin") {
+ if (isset($data["plugins"]) && in_array($this->pluginSlug, $data["plugins"])) {
\delete_transient($this->versionTransient);
}
}
@@ -332,54 +411,164 @@ class Updater
public function manualVersionCheck(): void
{
// Verify nonce
- if (!\wp_verify_nonce($_POST['nonce'] ?? '', $this->config->ajaxNonce)) {
+ $nonce = \sanitize_text_field(\wp_unslash($_POST["nonce"] ?? ""));
+ if (!\wp_verify_nonce($nonce, $this->config->ajaxNonce)) {
\wp_send_json_error([
- 'message' => 'Security check failed',
- 'code' => 'invalid_nonce'
+ "message" => $this->config->__("Security check failed"),
+ "code" => "invalid_nonce"
]);
}
-
- if (!\current_user_can('update_plugins')) {
+
+ if (!\current_user_can("update_plugins")) {
\wp_send_json_error([
- 'message' => 'Insufficient permissions',
- 'code' => 'insufficient_permissions'
+ "message" => $this->config->__("Insufficient permissions"),
+ "code" => "insufficient_permissions"
]);
}
try {
+ // Clear our version cache
\delete_transient($this->versionTransient);
+
+ // Clear WordPress update cache to force refresh
+ \delete_site_transient("update_plugins");
+
$latestVersion = $this->getLatestVersion();
+ $updateAvailable = $this->isUpdateAvailable();
+
+ // If update is available, set a transient to show admin notice
+ if ($updateAvailable) {
+ \set_transient("wp_github_updater_notice_{$this->pluginBasename}", [
+ "plugin_name" => $this->config->pluginName,
+ "current_version" => $this->currentVersion,
+ "latest_version" => $latestVersion,
+ "github_repo" => $this->config->githubRepo,
+ ], $this->config->cacheDuration); // Use same duration as version cache
+ }
\wp_send_json_success([
- 'current_version' => $this->currentVersion,
- 'latest_version' => $latestVersion ?: 'Unknown',
- 'update_available' => $latestVersion && version_compare($this->currentVersion, $latestVersion, '<'),
- 'github_repo' => $this->config->githubRepo,
+ "current_version" => $this->currentVersion,
+ "latest_version" => $latestVersion ?: $this->config->__("Unknown"),
+ "update_available" => $updateAvailable,
+ "github_repo" => $this->config->githubRepo,
+ "notice_set" => $updateAvailable, // Indicate if notice was set
]);
} catch (\Exception $e) {
\wp_send_json_error([
- 'message' => "Error checking for updates: {$e->getMessage()}",
- 'code' => 'version_check_failed'
+ "message" => sprintf($this->config->__("Error checking for updates: %s"), $e->getMessage()),
+ "code" => "version_check_failed"
]);
}
}
+ /**
+ * Handle dismissal of update notices via AJAX
+ *
+ * @since 1.1.4
+ * @return void
+ */
+ public function dismissUpdateNotice(): void
+ {
+ // Check nonce
+ $nonce = \sanitize_text_field(\wp_unslash($_POST["nonce"] ?? ""));
+ if (!\wp_verify_nonce($nonce, $this->config->ajaxNonce)) {
+ \wp_die("Security verification failed", "Error", ["response" => 403]);
+ }
+
+ // Check capabilities
+ if (!\current_user_can("update_plugins")) {
+ \wp_die("Insufficient permissions", "Error", ["response" => 403]);
+ }
+
+ // Delete the notice transient
+ $noticeKey = "wp_github_updater_notice_{$this->pluginBasename}";
+ \delete_transient($noticeKey);
+
+ \wp_send_json_success(["message" => "Notice dismissed successfully"]);
+ }
+
+ /**
+ * Show admin notice for available updates
+ *
+ * Displays a WordPress admin notice when an update is available
+ * after a manual version check.
+ *
+ * @since 1.1.4
+ */
+ public function showUpdateNotice(): void
+ {
+ // Only show on admin pages
+ if (!is_admin()) {
+ return;
+ }
+
+ // Check if we have a notice to show
+ $notice_data = \get_transient("wp_github_updater_notice_{$this->pluginBasename}");
+ if (!$notice_data) {
+ return;
+ }
+
+ // Only show to users who can update plugins
+ if (!\current_user_can("update_plugins")) {
+ return;
+ }
+
+ $plugin_name = $notice_data["plugin_name"] ?? $this->config->pluginName;
+ $current_version = $notice_data["current_version"] ?? $this->currentVersion;
+ $latest_version = $notice_data["latest_version"] ?? "Unknown";
+ $github_repo = $notice_data["github_repo"] ?? $this->config->githubRepo;
+
+ $updates_url = \admin_url("plugins.php?plugin_status=upgrade");
+ $github_url = "https://github.com/{$github_repo}/releases/latest";
+
+ echo '';
+
+ // Add JavaScript to handle dismissal
+ echo '';
+ }
+
/**
* Get plugin data from file
*/
private function getPluginData(): array
{
- if (!function_exists('get_plugin_data')) {
- require_once ABSPATH . 'wp-admin/includes/plugin.php';
+ if (!\function_exists("get_plugin_data")) {
+ require_once ABSPATH . "wp-admin/includes/plugin.php";
}
-
+
return \get_plugin_data($this->config->pluginFile);
}
/**
* Get current version
*
- * @return string
*/
public function getCurrentVersion(): string
{
@@ -389,7 +578,6 @@ class Updater
/**
* Get GitHub repository
*
- * @return string
*/
public function getGithubRepo(): string
{
@@ -399,12 +587,11 @@ class Updater
/**
* Check if update is available
*
- * @return bool
*/
public function isUpdateAvailable(): bool
{
$latestVersion = $this->getLatestVersion();
- return $latestVersion && version_compare($this->currentVersion, $latestVersion, '<');
+ return $latestVersion && version_compare($this->currentVersion, $latestVersion, "<");
}
/**
@@ -424,39 +611,320 @@ class Updater
$html = $markdown;
// Headers (# -> h2, ## -> h3, ### -> h4, #### -> h5)
- $html = preg_replace('/^#### (.*$)/m', '