Upload files to "/"

README.md

@@ -1,3 +1,54 @@
-# Ansico-plugins
+<<<<<<< HEAD
+# Ansico Plugins
 
-WP plugin that makes it possible to install and update other Ansico plugins on your WP site. It connect to this Forgejo server. 
+Ansico Plugins gives WordPress access to Ansico's private Forgejo-based plugin directory and lets administrators install, activate, reinstall, update and delete internal plugins from Ansico releases.
+
+## Installation
+
+1. Upload the plugin ZIP through WordPress, or copy the plugin folder to `/wp-content/plugins/`.
+2. Activate **Ansico Plugins**.
+3. Open **Settings → Ansico Plugins**.
+4. Review the default Ansico settings or click **Reset til Ansico standard**.
+5. Open **Plugins → Ansico Plugins** to browse available plugins.
+
+## Changelog
+
+### 1.0.0.2
+
+- Added support for parsing `readme.txt` in WordPress format.
+- Added tabbed plugin details view with Description, Installation, Changelog and Screenshots.
+- Added generated plugin icon and plugin banner assets.
+- Improved metadata extraction priority so `readme.txt` can drive plugin presentation.
+
+### 1.0.0
+
+- First stable release.
+- WordPress-style plugin catalogue UI.
+- Details popup with metadata and optional screenshot.
+- Install, activate, reinstall, update and delete actions.
+- Self-update support for Ansico Plugins.
+- Ansico default configuration and reset button.
+
+## Screenshots
+
+1. The Ansico Plugins catalogue in WordPress admin.
+2. The plugin details modal with tabs and metadata.
+
+## Support
+
+Support URL: https://ansico.dk/Ansico/Ansico-plugins
+=======
+# Ansico plugins
+
+Ansico plugins gives access to Ansico WP plugin directory, where Ansico plugins can be installed and updated. Not all Ansico plugins are published through WordPress official plugin directory, so to access all plugins this plugin must be installed. 
+
+## Installation
+
+1. Go to Plugins - Add plugin - Upload plugin.
+2. Upload plugin and activate it. 
+3. Check out plugins on Plugins - Ansico plugins.
+
+## Changelog
+
+- 1.0.0: First release.
+>>>>>>> ec08c13637360aaf9592f046aed0c4d9c179157e

ansico-plugins/README.md

@@ -1,45 +1,38 @@
 # Ansico Plugins
 
-Version: 1.0.0  
+Ansico Plugins gives WordPress access to Ansico's private Forgejo-based plugin directory and lets administrators install, activate, reinstall, update and delete internal plugins from Ansico releases.
-Contributor: aphandersen  
+
-Forfatter: Andreas Andersen (Ansico)  
+## Installation
-Author URL: https://ansico.dk  
+
+1. Upload the plugin ZIP through WordPress, or copy the plugin folder to `/wp-content/plugins/`.
+2. Activate **Ansico Plugins**.
+3. Open **Settings → Ansico Plugins**.
+4. Review the default Ansico settings or click **Reset til Ansico standard**.
+5. Open **Plugins → Ansico Plugins** to browse available plugins.
+
+## Changelog
+
+### 1.0.0.2
+
+- Added support for parsing `readme.txt` in WordPress format.
+- Added tabbed plugin details view with Description, Installation, Changelog and Screenshots.
+- Added generated plugin icon and plugin banner assets.
+- Improved metadata extraction priority so `readme.txt` can drive plugin presentation.
+
+### 1.0.0
+
+- First stable release.
+- WordPress-style plugin catalogue UI.
+- Details popup with metadata and optional screenshot.
+- Install, activate, reinstall, update and delete actions.
+- Self-update support for Ansico Plugins.
+- Ansico default configuration and reset button.
+
+## Screenshots
+
+1. The Ansico Plugins catalogue in WordPress admin.
+2. The plugin details modal with tabs and metadata.
+
+## Support
+
 Support URL: https://ansico.dk/Ansico/Ansico-plugins
-Licens: GPL-3.0-or-later  
-Testet på WordPress: 6.9.4  
-Kræver PHP: 7.0
-
-## Beskrivelse
-
-Gives access to Ansico plugin directory with Ansico plugins.
-
-## Formål
-
-Dette plugin forbinder WordPress til Ansico's Forgejo-server og giver adgang til Ansico plugins gennem et privat plugin-katalog.
-
-## Funktioner
-
-- Viser interne plugin-repositories fra Ansico
-- Åbner en WordPress-lignende popup med plugin-detaljer
-- Kan installere, aktivere, geninstallere, opdatere og afinstallere plugins
-- Kan læse metadata fra repository og plugin-header
-- Kan vise `screenshot.png`, hvis filen findes i repository-roden
-- Kan opdatere Ansico Plugins selv via release-systemet
-- Leveres med Ansico-standardindstillinger og reset-knap
-
-## Standardindstillinger
-
-Ved første installation er disse værdier udfyldt:
-
-- Forgejo URL: `https://ansico.dk`
-- Bruger eller organisation: `Ansico`
-- Access token: tom
-- Topic-filter: `wordpress-plugin`
-- Owner type: `Organisation`
-- Selvopdatering: aktiv
-- Ansico plugins owner: `Ansico`
-- Ansico plugins repository: `Ansico-plugins`
-
-## Release
-
-Denne version er klargjort som officiel release `1.0.0`.

ansico-plugins/ansico-plugins.php

@@ -3,7 +3,7 @@
  * Plugin Name: Ansico Plugins
  * Plugin URI: https://ansico.dk
  * Description: Gives access to Ansico plugin directory with Ansico plugins
- * Version: 1.0.0
+ * Version: 1.0.0.2
  * Author: Andreas Andersen (Ansico)
  * Author URI: https://ansico.dk
  * Contributors: aphandersen
@@ -20,7 +20,7 @@ if (!defined('ABSPATH')) {
     exit;
 }
 
-define('ANSICO_PLUGINS_VERSION', '1.0.0');
+define('ANSICO_PLUGINS_VERSION', '1.0.0.2');
 define('ANSICO_PLUGINS_MANAGED_OPTION', 'ansico_plugins_managed_plugins');
 define('ANSICO_PLUGINS_FILE', __FILE__);
 define('ANSICO_PLUGINS_DIR', plugin_dir_path(__FILE__));

ansico-plugins/includes/class-ansico-plugins-admin.php

@@ -333,13 +333,13 @@ class Ansico_Plugins_Admin {
 
                 echo '<div class="ansico-plugin-card">';
                 echo '<div class="ansico-plugin-card__top">';
-                echo '<div class="ansico-plugin-icon">AP</div>';
+                echo $this->get_plugin_icon_markup($metadata, $display_name);
                 echo '<div class="ansico-plugin-meta">';
                 echo '<h2><a href="' . esc_url($details_url) . '" class="thickbox">' . esc_html($display_name) . '</a></h2>';
                 echo '<div class="ansico-plugin-submeta">' . $badge . '</div>';
                 echo '</div></div>';
 
-                echo '<p class="ansico-plugin-description">' . esc_html(!empty($repo['description']) ? $repo['description'] : __('Ingen beskrivelse angivet.', 'ansico-plugins')) . '</p>';
+                echo '<p class="ansico-plugin-description">' . esc_html(!empty($metadata['description']) ? $metadata['description'] : (!empty($repo['description']) ? $repo['description'] : __('Ingen beskrivelse angivet.', 'ansico-plugins'))) . '</p>';
 
                 echo '<div class="ansico-plugin-facts">';
                 echo '<span><strong>' . esc_html__('Installeret', 'ansico-plugins') . ':</strong> ' . esc_html($plugin_state['installed_version'] !== '' ? $plugin_state['installed_version'] : '—') . '</span>';
@@ -563,12 +563,20 @@ class Ansico_Plugins_Admin {
 
     private function get_details_content_markup($repo, $release, $zip_asset, $plugin_state, $metadata) {
         $display_name = !empty($metadata['readme_title']) ? $metadata['readme_title'] : $repo['name'];
+        $description = !empty($metadata['description']) ? $metadata['description'] : (!empty($repo['description']) ? $repo['description'] : __('Ingen beskrivelse angivet.', 'ansico-plugins'));
+        $sections = !empty($metadata['readme_sections']) && is_array($metadata['readme_sections']) ? $metadata['readme_sections'] : array();
+        $is_wordpress_readme = !empty($metadata['readme_source']) && preg_match('/\.txt$/i', $metadata['readme_source']);
         $html = '';
+
+        if (!empty($metadata['banner_url'])) {
+            $html .= '<div class="ansico-plugin-banner"><img src="' . esc_url($metadata['banner_url']) . '" alt="' . esc_attr($display_name) . '" /></div>';
+        }
+
         $html .= '<div class="ansico-plugin-hero">';
-        $html .= '<div class="ansico-plugin-icon">AP</div>';
+        $html .= $this->get_plugin_icon_markup($metadata, $display_name);
         $html .= '<div>';
         $html .= '<h1 style="margin:0 0 8px;font-size:26px;line-height:1.2">' . esc_html($display_name) . '</h1>';
-        $html .= '<p class="description" style="margin:0 0 10px">' . esc_html(!empty($repo['description']) ? $repo['description'] : __('Ingen beskrivelse angivet.', 'ansico-plugins')) . '</p>';
+        $html .= '<p class="description" style="margin:0 0 10px">' . esc_html($description) . '</p>';
         $html .= $this->get_state_badge($plugin_state);
         $html .= '</div></div>';
 
@@ -579,7 +587,6 @@ class Ansico_Plugins_Admin {
         $html .= '<a class="button" href="' . esc_url($repo['html_url']) . '" target="_blank" rel="noopener noreferrer">' . esc_html__('Åbn repository', 'ansico-plugins') . '</a>';
         $html .= '</div>';
 
-        $html .= '<div class="ansico-meta-grid">';
         $meta_rows = array(
             __('Installeret version', 'ansico-plugins') => $plugin_state['installed_version'] !== '' ? $plugin_state['installed_version'] : '—',
             __('Seneste release', 'ansico-plugins') => !is_wp_error($release) ? $this->normalize_release_version($release) : '—',
@@ -592,8 +599,71 @@ class Ansico_Plugins_Admin {
             __('Plugin-URL', 'ansico-plugins') => !empty($metadata['plugin_headers']['PluginURI']) ? $metadata['plugin_headers']['PluginURI'] : '—',
             __('Kræver WordPress', 'ansico-plugins') => !empty($metadata['plugin_headers']['RequiresWP']) ? $metadata['plugin_headers']['RequiresWP'] : '—',
             __('Kræver PHP', 'ansico-plugins') => !empty($metadata['plugin_headers']['RequiresPHP']) ? $metadata['plugin_headers']['RequiresPHP'] : '—',
-            __('Text domain', 'ansico-plugins') => !empty($metadata['plugin_headers']['TextDomain']) ? $metadata['plugin_headers']['TextDomain'] : '—',
         );
+        if (!empty($metadata['plugin_headers']['TextDomain'])) {
+            $meta_rows[__('Text domain', 'ansico-plugins')] = $metadata['plugin_headers']['TextDomain'];
+        }
+
+        $tabs = array();
+        $tabs[] = array(
+            'slug' => 'description',
+            'label' => __('Beskrivelse', 'ansico-plugins'),
+            'content' => $this->render_readme_section(!empty($sections['description']) ? $sections['description'] : $description, $is_wordpress_readme),
+        );
+        if (!empty($sections['installation'])) {
+            $tabs[] = array(
+                'slug' => 'installation',
+                'label' => __('Installation', 'ansico-plugins'),
+                'content' => $this->render_readme_section($sections['installation'], $is_wordpress_readme),
+            );
+        }
+        if (!empty($sections['changelog'])) {
+            $tabs[] = array(
+                'slug' => 'changelog',
+                'label' => __('Changelog', 'ansico-plugins'),
+                'content' => $this->render_readme_section($sections['changelog'], $is_wordpress_readme),
+            );
+        }
+        if (!empty($metadata['screenshot_url']) || !empty($sections['screenshots'])) {
+            $screen = '';
+            if (!empty($metadata['screenshot_url'])) {
+                $screen .= '<p><img src="' . esc_url($metadata['screenshot_url']) . '" alt="' . esc_attr(sprintf(__('Screenshot for %s', 'ansico-plugins'), $display_name)) . '" /></p>';
+            }
+            if (!empty($sections['screenshots'])) {
+                $screen .= $this->render_readme_section($sections['screenshots'], $is_wordpress_readme);
+            }
+            $tabs[] = array(
+                'slug' => 'screenshots',
+                'label' => __('Screenshots', 'ansico-plugins'),
+                'content' => $screen,
+            );
+        }
+        $tabs[] = array(
+            'slug' => 'metadata',
+            'label' => __('Metadata', 'ansico-plugins'),
+            'content' => $this->render_metadata_grid($meta_rows),
+        );
+        if (!is_wp_error($release) && !empty($release['body'])) {
+            $tabs[] = array(
+                'slug' => 'release-notes',
+                'label' => __('Release-noter', 'ansico-plugins'),
+                'content' => '<div class="ansico-release-notes">' . wp_kses_post(wpautop($release['body'])) . '</div>',
+            );
+        }
+
+        $html .= $this->render_details_tabs($tabs, $repo['name']);
+        return $html;
+    }
+
+    private function get_plugin_icon_markup($metadata, $display_name) {
+        if (!empty($metadata['icon_url'])) {
+            return '<div class="ansico-plugin-icon ansico-plugin-icon--image"><img src="' . esc_url($metadata['icon_url']) . '" alt="' . esc_attr($display_name) . '" /></div>';
+        }
+        return '<div class="ansico-plugin-icon">AP</div>';
+    }
+
+    private function render_metadata_grid($meta_rows) {
+        $html = '<div class="ansico-meta-grid">';
         foreach ($meta_rows as $label => $value) {
             $html .= '<p><strong>' . esc_html($label) . '</strong><br>';
             if (is_string($value) && preg_match('#^https?://#i', $value)) {
@@ -604,22 +674,59 @@ class Ansico_Plugins_Admin {
             $html .= '</p>';
         }
         $html .= '</div>';
-
-        if (!empty($metadata['screenshot_url'])) {
-            $html .= '<div class="ansico-screenshot" style="margin:22px 0">';
-            $html .= '<h2>' . esc_html__('Screenshot', 'ansico-plugins') . '</h2>';
-            $html .= '<img src="' . esc_url($metadata['screenshot_url']) . '" alt="' . esc_attr(sprintf(__('Screenshot for %s', 'ansico-plugins'), $display_name)) . '" />';
-            $html .= '</div>';
-        }
-
-        if (!is_wp_error($release) && !empty($release['body'])) {
-            $html .= '<h2>' . esc_html__('Release-noter', 'ansico-plugins') . '</h2>';
-            $html .= '<div class="ansico-release-notes">' . wp_kses_post(wpautop($release['body'])) . '</div>';
-        }
-
         return $html;
     }
 
+    private function render_details_tabs($tabs, $repo_name) {
+        $id_base = 'ansico-tabs-' . sanitize_title($repo_name);
+        $html = '<div class="ansico-tabs"><div class="ansico-tab-nav" role="tablist">';
+        foreach ($tabs as $index => $tab) {
+            $active = 0 === $index ? ' is-active' : '';
+            $html .= '<button type="button" class="ansico-tab-button' . $active . '" data-target="#' . esc_attr($id_base . '-' . $tab['slug']) . '">' . esc_html($tab['label']) . '</button>';
+        }
+        $html .= '</div>';
+        foreach ($tabs as $index => $tab) {
+            $active = 0 === $index ? ' is-active' : '';
+            $html .= '<div id="' . esc_attr($id_base . '-' . $tab['slug']) . '" class="ansico-tab-panel' . $active . '">' . $tab['content'] . '</div>';
+        }
+        $html .= '</div>';
+        return $html;
+    }
+
+    private function render_readme_section($content, $is_wordpress_readme = false) {
+        $content = trim((string) $content);
+        if ('' === $content) {
+            return '<p>' . esc_html__('Ingen oplysninger tilgængelige.', 'ansico-plugins') . '</p>';
+        }
+        if ($is_wordpress_readme) {
+            return wp_kses_post(wpautop($this->format_wordpress_readme_text($content)));
+        }
+        return wp_kses_post(wpautop($this->format_markdown_text($content)));
+    }
+
+    private function format_wordpress_readme_text($content) {
+        $content = preg_replace('/^=\s*(.+?)\s*=\s*$/m', "
+<strong>$1</strong>
+", $content);
+        $content = preg_replace('/^\*\s+/m', '• ', $content);
+        return $content;
+    }
+
+    private function format_markdown_text($content) {
+        $content = preg_replace('/^###\s+(.+)$/m', "
+<strong>$1</strong>
+", $content);
+        $content = preg_replace('/^##\s+(.+)$/m', "
+<strong>$1</strong>
+", $content);
+        $content = preg_replace('/^#\s+(.+)$/m', "
+<strong>$1</strong>
+", $content);
+        $content = preg_replace('/^[-*]\s+/m', '• ', $content);
+        $content = preg_replace('/`([^`]+)`/', '$1', $content);
+        return $content;
+    }
+
     private function render_catalog_styles() {
         echo '<style>
             .ansico-directory-header{display:flex;justify-content:space-between;align-items:center;margin:16px 0 20px}
@@ -631,7 +738,7 @@ class Ansico_Plugins_Admin {
             .ansico-plugin-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(320px,1fr));gap:20px;margin-top:18px}
             .ansico-plugin-card{background:#fff;border:1px solid #dcdcde;border-radius:10px;padding:18px;box-shadow:0 1px 2px rgba(0,0,0,.04);display:flex;flex-direction:column;gap:14px}
             .ansico-plugin-card__top{display:flex;gap:14px;align-items:flex-start}
-            .ansico-plugin-icon{width:64px;height:64px;border-radius:12px;background:#2271b1;color:#fff;display:flex;align-items:center;justify-content:center;font-weight:700;font-size:20px;flex-shrink:0}
+            .ansico-plugin-icon{width:64px;height:64px;border-radius:12px;background:#2271b1;color:#fff;display:flex;align-items:center;justify-content:center;font-weight:700;font-size:20px;flex-shrink:0;overflow:hidden}.ansico-plugin-icon--image{background:#fff;border:1px solid #dcdcde}.ansico-plugin-icon img{width:100%;height:100%;object-fit:cover;display:block}
             .ansico-plugin-meta h2{margin:0 0 6px;font-size:18px;line-height:1.3}
             .ansico-plugin-meta h2 a{text-decoration:none}
             .ansico-plugin-submeta{display:flex;gap:8px;align-items:center;flex-wrap:wrap;color:#646970}
@@ -647,12 +754,12 @@ class Ansico_Plugins_Admin {
             .ansico-plugin-hero .ansico-plugin-icon{width:72px;height:72px;font-size:22px}
             .ansico-meta-grid{display:grid;grid-template-columns:1fr 1fr;gap:10px 20px;margin:18px 0}
             .ansico-meta-grid p{margin:0}
-            .ansico-screenshot img{max-width:100%;height:auto;border:1px solid #dcdcde;border-radius:8px}
+            .ansico-plugin-banner{margin:0 0 18px}.ansico-plugin-banner img{width:100%;height:auto;border-radius:10px;border:1px solid #dcdcde;display:block}.ansico-screenshot img,.ansico-tab-panel img{max-width:100%;height:auto;border:1px solid #dcdcde;border-radius:8px}
             .ansico-modal-actions{display:flex;gap:10px;flex-wrap:wrap;margin:18px 0}
             .ansico-release-notes{background:#f6f7f7;border-radius:8px;padding:14px}
-            .ansico-thickbox-content{padding:20px 24px 24px}
+            .ansico-thickbox-content{padding:20px 24px 24px}.ansico-tabs{margin-top:18px}.ansico-tab-nav{display:flex;gap:8px;flex-wrap:wrap;border-bottom:1px solid #dcdcde;margin-bottom:16px;padding-bottom:8px}.ansico-tab-button{background:#f6f7f7;border:1px solid #dcdcde;border-radius:6px 6px 0 0;padding:8px 12px;cursor:pointer}.ansico-tab-button.is-active{background:#fff;border-bottom-color:#fff;font-weight:600}.ansico-tab-panel{display:none}.ansico-tab-panel.is-active{display:block}
             #TB_window{max-height:81vh !important}#TB_ajaxContent{max-height:calc(81vh - 45px) !important;height:auto !important;overflow:auto !important}#TB_ajaxContent .ansico-thickbox-content{width:auto !important;height:auto !important;max-height:calc(81vh - 65px) !important;overflow:auto !important;padding:20px 24px 24px !important;box-sizing:border-box}
             @media (max-width: 960px){.ansico-meta-grid{grid-template-columns:1fr}}
-        </style>';
+        </style><script>document.addEventListener("click",function(e){var btn=e.target.closest(".ansico-tab-button");if(!btn){return;}var wrap=btn.closest(".ansico-tabs");if(!wrap){return;}var targetSel=btn.getAttribute("data-target");wrap.querySelectorAll(".ansico-tab-button").forEach(function(el){el.classList.remove("is-active");});wrap.querySelectorAll(".ansico-tab-panel").forEach(function(el){el.classList.remove("is-active");});btn.classList.add("is-active");var panel=wrap.querySelector(targetSel);if(panel){panel.classList.add("is-active");}});</script>';
     }
 }

ansico-plugins/includes/class-ansico-plugins-client.php

@@ -303,23 +303,188 @@ class Ansico_Plugins_Client {
 
 
     public function get_repository_readme_title($owner, $repo_name, $ref = '') {
-        $candidates = array('README.md', 'readme.md', 'Readme.md');
+        $documentation = $this->get_repository_documentation($owner, $repo_name, $ref);
+        if (is_wp_error($documentation)) {
+            return '';
+        }
+        return !empty($documentation['title']) ? (string) $documentation['title'] : '';
+    }
+
+    public function get_repository_documentation($owner, $repo_name, $ref = '') {
+        $candidates = array('readme.txt', 'README.txt', 'README.md', 'readme.md', 'Readme.md');
         foreach ($candidates as $candidate) {
-            $file = $this->get_repository_contents($owner, $repo_name, $candidate, $ref);
+            $raw = $this->get_repository_text_file($owner, $repo_name, $candidate, $ref);
-            if (is_wp_error($file) || !is_array($file) || empty($file['content']) || empty($file['encoding']) || 'base64' !== $file['encoding']) {
+            if ('' === $raw) {
                 continue;
             }
 
-            $raw = base64_decode((string) $file['content'], true);
+            if (preg_match('/\.txt$/i', $candidate)) {
-            if (false === $raw) {
+                $parsed = $this->parse_wordpress_readme($raw);
-                continue;
+            } else {
+                $parsed = $this->parse_markdown_readme($raw);
             }
 
-            if (preg_match('/^\#\s+(.+)$/m', (string) $raw, $matches)) {
+            if (!empty($parsed['title']) || !empty($parsed['short_description']) || !empty($parsed['sections'])) {
-                return trim(wp_strip_all_tags($matches[1]));
+                $parsed['source'] = $candidate;
+                return $parsed;
             }
         }
 
+        return array(
+            'title' => '',
+            'short_description' => '',
+            'sections' => array(),
+            'source' => '',
+        );
+    }
+
+    private function get_repository_text_file($owner, $repo_name, $path, $ref = '') {
+        $file = $this->get_repository_contents($owner, $repo_name, $path, $ref);
+        if (is_wp_error($file) || !is_array($file) || empty($file['content']) || empty($file['encoding']) || 'base64' !== $file['encoding']) {
+            return '';
+        }
+
+        $raw = base64_decode((string) $file['content'], true);
+        if (false === $raw) {
+            return '';
+        }
+
+        return str_replace(array("
+", "
"), "
+", (string) $raw);
+    }
+
+    private function parse_wordpress_readme($raw) {
+        $raw = trim((string) $raw);
+        $lines = preg_split('/
+/', $raw);
+        $title = '';
+        $short_description = '';
+        $sections = array();
+        $current = '';
+        $buffer = array();
+        $header_done = false;
+
+        foreach ($lines as $line) {
+            if ('' === $title && preg_match('/^===\s*(.+?)\s*===\s*$/', $line, $m)) {
+                $title = trim($m[1]);
+                continue;
+            }
+
+            if (!$header_done && preg_match('/^==\s*(.+?)\s*==\s*$/', $line, $m)) {
+                $header_done = true;
+                $current = strtolower(trim($m[1]));
+                $buffer = array();
+                continue;
+            }
+
+            if (!$header_done) {
+                if ('' === $short_description && '' !== trim($line) && false === strpos($line, ':')) {
+                    $short_description = trim($line);
+                }
+                continue;
+            }
+
+            if (preg_match('/^==\s*(.+?)\s*==\s*$/', $line, $m)) {
+                if ('' !== $current) {
+                    $sections[$current] = trim(implode("
+", $buffer));
+                }
+                $current = strtolower(trim($m[1]));
+                $buffer = array();
+                continue;
+            }
+
+            $buffer[] = $line;
+        }
+
+        if ('' !== $current) {
+            $sections[$current] = trim(implode("
+", $buffer));
+        }
+
+        if ('' === $short_description && !empty($sections['description'])) {
+            $short_description = $this->first_paragraph($sections['description']);
+        }
+
+        return array(
+            'title' => $title,
+            'short_description' => $short_description,
+            'sections' => $sections,
+        );
+    }
+
+    private function parse_markdown_readme($raw) {
+        $title = '';
+        $short_description = '';
+        $sections = array();
+        $current = '';
+        $buffer = array();
+        $after_title = '';
+
+        foreach (preg_split('/
+/', (string) $raw) as $line) {
+            if ('' === $title && preg_match('/^#\s+(.+)$/', $line, $m)) {
+                $title = trim(wp_strip_all_tags($m[1]));
+                continue;
+            }
+
+            if (preg_match('/^##\s+(.+)$/', $line, $m)) {
+                if ('' !== $current) {
+                    $sections[$current] = trim(implode("
+", $buffer));
+                }
+                $current = strtolower(trim(wp_strip_all_tags($m[1])));
+                $buffer = array();
+                continue;
+            }
+
+            if ('' === $current) {
+                $after_title .= $line . "
+";
+            } else {
+                $buffer[] = $line;
+            }
+        }
+
+        if ('' !== $current) {
+            $sections[$current] = trim(implode("
+", $buffer));
+        }
+
+        $short_description = $this->first_paragraph($after_title);
+        if ('' === $short_description && !empty($sections['description'])) {
+            $short_description = $this->first_paragraph($sections['description']);
+        }
+
+        return array(
+            'title' => $title,
+            'short_description' => $short_description,
+            'sections' => $sections,
+        );
+    }
+
+    private function first_paragraph($text) {
+        $text = trim((string) $text);
+        if ('' === $text) {
+            return '';
+        }
+        $parts = preg_split("/
+\s*
+/", $text);
+        if (empty($parts[0])) {
+            return '';
+        }
+        return trim(wp_strip_all_tags($parts[0]));
+    }
+
+    private function find_repository_asset_url($owner, $repo_name, $default_branch, $candidates) {
+        foreach ((array) $candidates as $candidate) {
+            $file = $this->get_repository_contents($owner, $repo_name, $candidate, $default_branch);
+            if (!is_wp_error($file) && is_array($file) && !empty($file['download_url'])) {
+                return (string) $file['download_url'];
+            }
+        }
         return '';
     }
 
@@ -331,54 +496,53 @@ class Ansico_Plugins_Client {
 
         $default_branch = !empty($repo['default_branch']) ? (string) $repo['default_branch'] : '';
         $root = $this->get_repository_contents($owner, $repo_name, '', $default_branch);
-        if (is_wp_error($root) || !is_array($root)) {
-            return array(
-                'readme_title' => '',
-                'author_name' => !empty($repo['owner']['full_name']) ? (string) $repo['owner']['full_name'] : (!empty($repo['owner']['login']) ? (string) $repo['owner']['login'] : ''),
-                'author_url' => !empty($repo['owner']['website']) ? (string) $repo['owner']['website'] : (!empty($repo['owner']['html_url']) ? (string) $repo['owner']['html_url'] : ''),
-                'plugin_headers' => array(),
-                'support_url' => !empty($repo['html_url']) ? trailingslashit((string) $repo['html_url']) . 'issues' : '',
-                'license' => !empty($repo['license']['spdx_id']) ? (string) $repo['license']['spdx_id'] : '',
-                'screenshot_url' => '',
-                'default_branch' => $default_branch,
-            );
-        }
-
-        $screenshot_url = '';
         $plugin_headers = array();
-        foreach ($root as $item) {
+
-            if (!is_array($item) || empty($item['name'])) {
+        if (!is_wp_error($root) && is_array($root)) {
-                continue;
+            foreach ($root as $item) {
-            }
+                if (!is_array($item) || empty($item['name'])) {
-            $name = (string) $item['name'];
+                    continue;
-            if (strtolower($name) === 'screenshot.png' && !empty($item['download_url'])) {
+                }
-                $screenshot_url = (string) $item['download_url'];
+                $name = (string) $item['name'];
-            }
+                if (empty($plugin_headers) && !empty($item['type']) && 'file' === $item['type'] && preg_match('/\.php$/i', $name)) {
-            if (empty($plugin_headers) && !empty($item['type']) && 'file' === $item['type'] && preg_match('/\.php$/i', $name)) {
+                    $file = $this->get_repository_contents($owner, $repo_name, $name, $default_branch);
-                $file = $this->get_repository_contents($owner, $repo_name, $name, $default_branch);
+                    if (!is_wp_error($file) && is_array($file) && !empty($file['content']) && !empty($file['encoding']) && 'base64' === $file['encoding']) {
-                if (!is_wp_error($file) && is_array($file) && !empty($file['content']) && !empty($file['encoding']) && 'base64' === $file['encoding']) {
+                        $raw = base64_decode((string) $file['content'], true);
-                    $raw = base64_decode((string) $file['content'], true);
+                        if (false !== $raw) {
-                    if (false !== $raw) {
+                            $plugin_headers = $this->parse_plugin_headers($raw);
-                        $plugin_headers = $this->parse_plugin_headers($raw);
+                        }
                     }
                 }
             }
         }
 
-        $readme_title = $this->get_repository_readme_title($owner, $repo_name, $default_branch);
+        $documentation = $this->get_repository_documentation($owner, $repo_name, $default_branch);
+        if (is_wp_error($documentation)) {
+            $documentation = array('title' => '', 'short_description' => '', 'sections' => array(), 'source' => '');
+        }
+
         $author_name = !empty($plugin_headers['Author']) ? (string) $plugin_headers['Author'] : (!empty($repo['owner']['full_name']) ? (string) $repo['owner']['full_name'] : (!empty($repo['owner']['login']) ? (string) $repo['owner']['login'] : ''));
         $author_url = !empty($plugin_headers['AuthorURI']) ? (string) $plugin_headers['AuthorURI'] : (!empty($repo['owner']['website']) ? (string) $repo['owner']['website'] : (!empty($repo['owner']['html_url']) ? (string) $repo['owner']['html_url'] : ''));
         $support_url = !empty($plugin_headers['SupportURI']) ? (string) $plugin_headers['SupportURI'] : (!empty($repo['html_url']) ? trailingslashit((string) $repo['html_url']) . 'issues' : '');
         $license = !empty($plugin_headers['License']) ? (string) $plugin_headers['License'] : (!empty($repo['license']['spdx_id']) ? (string) $repo['license']['spdx_id'] : '');
 
+        $screenshot_url = $this->find_repository_asset_url($owner, $repo_name, $default_branch, array('screenshot.png', 'assets/screenshot.png'));
+        $icon_url = $this->find_repository_asset_url($owner, $repo_name, $default_branch, array('icon-256x256.png', 'icon-128x128.png', 'assets/icon-256x256.png', 'assets/icon-128x128.png'));
+        $banner_url = $this->find_repository_asset_url($owner, $repo_name, $default_branch, array('banner-1544x500.png', 'banner-772x250.png', 'assets/banner-1544x500.png', 'assets/banner-772x250.png'));
+
         return array(
-            'readme_title' => $readme_title,
+            'readme_title' => !empty($documentation['title']) ? $documentation['title'] : '',
+            'description' => !empty($documentation['short_description']) ? $documentation['short_description'] : (!empty($repo['description']) ? (string) $repo['description'] : ''),
+            'readme_sections' => !empty($documentation['sections']) && is_array($documentation['sections']) ? $documentation['sections'] : array(),
+            'readme_source' => !empty($documentation['source']) ? $documentation['source'] : '',
             'author_name' => $author_name,
             'author_url' => $author_url,
             'plugin_headers' => $plugin_headers,
             'support_url' => $support_url,
             'license' => $license,
             'screenshot_url' => $screenshot_url,
+            'icon_url' => $icon_url,
+            'banner_url' => $banner_url,
             'default_branch' => $default_branch,
         );
     }

ansico-plugins/readme.txt

@@ -4,7 +4,7 @@ Tags: forgejo, plugins, private directory, ansico
 Requires at least: 6.3
 Tested up to: 6.9.4
 Requires PHP: 7.0
-Stable tag: 1.0.0
+Stable tag: 1.0.0.2
 License: GPL-3.0-or-later
 License URI: https://www.gnu.org/licenses/gpl-3.0.html
 
@@ -12,7 +12,7 @@ Gives access to Ansico plugin directory with Ansico plugins.
 
 == Description ==
 
-Ansico Plugins gives WordPress access to Ansico's private Forgejo-based plugin directory and lets administrators install, activate, reinstall, update, and delete internal plugins from Ansico releases.
+Ansico Plugins gives WordPress access to Ansico's private Forgejo-based plugin directory and lets administrators install, activate, reinstall, update and delete internal plugins from Ansico releases.
 
 = Features =
 
@@ -21,9 +21,10 @@ Ansico Plugins gives WordPress access to Ansico's private Forgejo-based plugin d
 * Reads plugin metadata and README content from repositories.
 * Opens a WordPress-style details popup for each plugin.
 * Installs plugins from the latest Forgejo release ZIP.
-* Supports activate, reinstall, update, and delete actions.
+* Supports activate, reinstall, update and delete actions.
 * Supports self-updates for Ansico Plugins itself.
 * Includes Ansico default settings and a reset button.
+* Supports plugin presentation from `readme.txt` in WordPress format.
 
 == Installation ==
 
@@ -43,12 +44,23 @@ Yes. Public Ansico repositories can be listed without a token. A token can still
 
 Yes. Self-update support is built in and can check the configured Ansico Plugins repository for newer releases.
 
+== Screenshots ==
+
+1. The Ansico Plugins catalogue in WordPress admin.
+2. The plugin details modal with tabs and metadata.
+
 == Changelog ==
 
+= 1.0.0.2 =
+* Added support for parsing `readme.txt` in WordPress format.
+* Added tabbed plugin details view with Description, Installation, Changelog and Screenshots.
+* Added generated plugin icon and plugin banner assets.
+* Improved metadata extraction priority so `readme.txt` can drive plugin presentation.
+
 = 1.0.0 =
 * First stable release.
 * WordPress-style plugin catalogue UI.
 * Details popup with metadata and optional screenshot.
-* Install, activate, reinstall, update, and delete actions.
+* Install, activate, reinstall, update and delete actions.
 * Self-update support for Ansico Plugins.
 * Ansico default configuration and reset button.

readme.txt

@@ -0,0 +1,66 @@
+=== Ansico Plugins ===
+Contributors: aphandersen
+Tags: forgejo, plugins, private directory, ansico
+Requires at least: 6.3
+Tested up to: 6.9.4
+Requires PHP: 7.0
+Stable tag: 1.0.0.2
+License: GPL-3.0-or-later
+License URI: https://www.gnu.org/licenses/gpl-3.0.html
+
+Gives access to Ansico plugin directory with Ansico plugins.
+
+== Description ==
+
+Ansico Plugins gives WordPress access to Ansico's private Forgejo-based plugin directory and lets administrators install, activate, reinstall, update and delete internal plugins from Ansico releases.
+
+= Features =
+
+* Connects WordPress to Ansico's Forgejo server.
+* Lists internal plugin repositories from Ansico.
+* Reads plugin metadata and README content from repositories.
+* Opens a WordPress-style details popup for each plugin.
+* Installs plugins from the latest Forgejo release ZIP.
+* Supports activate, reinstall, update and delete actions.
+* Supports self-updates for Ansico Plugins itself.
+* Includes Ansico default settings and a reset button.
+* Supports plugin presentation from `readme.txt` in WordPress format.
+
+== Installation ==
+
+1. Upload the plugin ZIP through WordPress, or copy the plugin folder to `/wp-content/plugins/`.
+2. Activate **Ansico Plugins**.
+3. Open **Settings -> Ansico Plugins**.
+4. Review the default Ansico settings or click **Reset til Ansico standard**.
+5. Open **Plugins -> Ansico Plugins** to browse available plugins.
+
+== Frequently Asked Questions ==
+
+= Does it work without an access token? =
+
+Yes. Public Ansico repositories can be listed without a token. A token can still be added for private repositories or stricter API access.
+
+= Can Ansico Plugins update itself? =
+
+Yes. Self-update support is built in and can check the configured Ansico Plugins repository for newer releases.
+
+== Screenshots ==
+
+1. The Ansico Plugins catalogue in WordPress admin.
+2. The plugin details modal with tabs and metadata.
+
+== Changelog ==
+
+= 1.0.0.2 =
+* Added support for parsing `readme.txt` in WordPress format.
+* Added tabbed plugin details view with Description, Installation, Changelog and Screenshots.
+* Added generated plugin icon and plugin banner assets.
+* Improved metadata extraction priority so `readme.txt` can drive plugin presentation.
+
+= 1.0.0 =
+* First stable release.
+* WordPress-style plugin catalogue UI.
+* Details popup with metadata and optional screenshot.
+* Install, activate, reinstall, update and delete actions.
+* Self-update support for Ansico Plugins.
+* Ansico default configuration and reset button.