defined( 'FE_GITEA_API_URL' ) ? (string) FE_GITEA_API_URL : '', 'owner' => defined( 'FE_GITEA_OWNER' ) ? (string) FE_GITEA_OWNER : '', 'repo' => defined( 'FE_GITEA_REPO' ) ? (string) FE_GITEA_REPO : '', 'token' => defined( 'FE_GITEA_TOKEN' ) ? (string) FE_GITEA_TOKEN : '', ); /** * Filters the Gitea updater configuration. * * @param array $config Keys: api_url, owner, repo, token. */ return wp_parse_args( apply_filters( 'fe_updater_config', $config ), $config ); } /** * Whether the updater has enough configuration to run. * * @return bool */ private static function is_configured() { $config = self::config(); return '' !== $config['api_url'] && '' !== $config['owner'] && '' !== $config['repo']; } /** * Fetches the latest usable release from the Gitea API (cached). * * @return array|null Keys: version, tag, name, body, html_url, package. Null on failure. */ private static function get_latest_release() { if ( ! self::is_configured() ) { return null; } $config = self::config(); $cache = get_transient( self::CACHE_KEY ); if ( false !== $cache && is_array( $cache ) ) { return $cache; } $url = trailingslashit( $config['api_url'] ) . 'repos/' . rawurlencode( $config['owner'] ) . '/' . rawurlencode( $config['repo'] ) . '/releases?limit=30'; $args = array( 'timeout' => 10, 'headers' => array( 'Accept' => 'application/json' ), ); if ( '' !== $config['token'] ) { $args['headers']['Authorization'] = 'token ' . $config['token']; } $response = wp_remote_get( $url, $args ); if ( is_wp_error( $response ) || 200 !== (int) wp_remote_retrieve_response_code( $response ) ) { return null; } $releases = json_decode( (string) wp_remote_retrieve_body( $response ), true ); if ( ! is_array( $releases ) ) { return null; } $api_host = (string) wp_parse_url( $config['api_url'], PHP_URL_HOST ); $best = null; foreach ( $releases as $release ) { if ( ! empty( $release['draft'] ) || ! empty( $release['prerelease'] ) ) { continue; } $version = ltrim( (string) ( $release['tag_name'] ?? '' ), 'vV' ); if ( '' === $version || ! preg_match( '/^\d+(\.\d+)*/', $version ) ) { continue; } $package = ''; if ( ! empty( $release['assets'] ) && is_array( $release['assets'] ) ) { foreach ( $release['assets'] as $asset ) { $name = (string) ( $asset['name'] ?? '' ); $link = (string) ( $asset['browser_download_url'] ?? '' ); if ( '.zip' === substr( strtolower( $name ), -4 ) && self::same_host( $link, $api_host ) ) { // Prefer an asset named after the plugin slug. if ( FE_SLUG . '.zip' === strtolower( $name ) ) { $package = $link; break; } if ( '' === $package ) { $package = $link; } } } } if ( '' === $package ) { continue; } $candidate = array( 'version' => $version, 'tag' => (string) $release['tag_name'], 'name' => (string) ( $release['name'] ?: $release['tag_name'] ), 'body' => (string) ( $release['body'] ?? '' ), 'html_url' => (string) ( $release['html_url'] ?? '' ), 'package' => $package, ); if ( null === $best || version_compare( $candidate['version'], $best['version'], '>' ) ) { $best = $candidate; } } if ( null !== $best ) { set_transient( self::CACHE_KEY, $best, self::CACHE_TTL ); } return $best; } /** * Checks whether a URL belongs to the configured Gitea host. * * @param string $url Candidate URL. * @param string $api_host Expected host. * @return bool */ private static function same_host( $url, $api_host ) { $host = wp_parse_url( $url, PHP_URL_HOST ); return is_string( $host ) && strtolower( $host ) === strtolower( (string) $api_host ); } /** * Injects the remote version into the update_plugins transient. * * @param object $transient Update transient value. * @return object */ public static function check_for_updates( $transient ) { if ( ! is_object( $transient ) ) { $transient = new stdClass(); } $release = self::get_latest_release(); if ( null === $release ) { return $transient; } if ( version_compare( $release['version'], FE_VERSION, '>' ) ) { $transient->response[ FE_SLUG ] = (object) array( 'slug' => FE_SLUG, 'plugin' => plugin_basename( FE_PLUGIN_FILE ), 'new_version' => $release['version'], 'url' => $release['html_url'], 'package' => $release['package'], 'tested' => get_bloginfo( 'version' ), ); } return $transient; } /** * Serves plugin information for the "View details" modal. * * @param mixed $result Result object or false. * @param string $action plugins_api action. * @param object $args Request args. * @return mixed */ public static function plugin_info( $result, $action, $args ) { if ( 'plugin_information' !== $action || ! isset( $args->slug ) || FE_SLUG !== $args->slug ) { return $result; } $release = self::get_latest_release(); if ( null === $release ) { return $result; } return (object) array( 'name' => __( '404 Enhancer', '404-enhancer' ), 'slug' => FE_SLUG, 'version' => $release['version'], 'author' => 'Your Name', 'homepage' => $release['html_url'], 'download_link' => $release['package'], 'tested' => get_bloginfo( 'version' ), 'sections' => array( 'description' => __( 'Enhances the 404 page with a custom message, featured image, hand-picked content, search and URL-based suggestions.', '404-enhancer' ), 'changelog' => $release['body'] ? wp_kses_post( nl2br( $release['body'] ) ) : __( 'No changelog provided.', '404-enhancer' ), ), ); } }