tags.
+ *
+ * @since 2.0.0
+ *
+ * @param string $content Content to escape.
+ *
+ * @return string Escaped content.
+ */
+ private function escape_code_blocks( string $content ): string {
+ return (string) preg_replace_callback(
+ '/`{1,3}([^`]+)`{1,3}/',
+ function ( $matches ) {
+ $is_multiline = strpos( $matches[0], '```' ) !== false;
+ $code = esc_html( trim( $matches[1] ) );
+
+ if ( $is_multiline ) {
+ $code = preg_replace( '/\n/', '
', $code );
+
+ return "\n\n" . '' . $code . '' . "\n\n";
+ }
+
+ return '' . $code . '';
+ },
+ $content
+ );
+ }
+
+ /**
+ * Converts bold text in the content to tags.
+ *
+ * @since 2.0.0
+ *
+ * @param string $content Content to convert.
+ *
+ * @return string Converted content.
+ */
+ private function convert_bold_text( string $content ): string {
+ return (string) preg_replace(
+ '/\*\*([^\*]+)\*\*/',
+ '$1',
+ $content
+ );
+ }
+
+ /**
+ * Converts italic text styled as *italic* in the content to tags.
+ * _italic_ text is not converted, as attempting to account for this would be too complex as that pattern would often have false positives with things like action and filter names.
+ *
+ * @since 2.0.0
+ *
+ * @param string $content Content to convert.
+ *
+ * @return string Converted content.
+ */
+ private function convert_italic_text( string $content ): string {
+ return (string) preg_replace(
+ '/(?$1',
+ $content
+ );
+ }
+}
diff --git a/src/ChangelogEmbed/GitHub_API.php b/src/ChangelogEmbed/GitHub_API.php
new file mode 100644
index 0000000..1eea1a8
--- /dev/null
+++ b/src/ChangelogEmbed/GitHub_API.php
@@ -0,0 +1,138 @@
+api_base_url,
+ rawurlencode( $owner ),
+ rawurlencode( $repo ),
+ rawurlencode( $file_path ),
+ rawurlencode( $branch )
+ );
+
+ // Set up request arguments.
+ $args = [
+ 'headers' => [
+ 'Accept' => 'application/vnd.github.v4.raw',
+ 'User-Agent' => 'WordPress/' . get_bloginfo( 'version' ) . '; ' . get_bloginfo( 'url' ),
+ ],
+ 'timeout' => 30,
+ ];
+
+ // Add authentication if token is set.
+ $github_token = get_option( 'stellar_changelog_embed_github_token', '' );
+
+ if ( ! empty( $github_token ) ) {
+ $args['headers']['Authorization'] = 'token ' . $github_token;
+ }
+
+ // Make the request.
+ $response = wp_remote_get( $url, $args );
+
+ // Check for errors.
+ if ( is_wp_error( $response ) ) {
+ return $response;
+ }
+
+ // Check response code.
+ $response_code = wp_remote_retrieve_response_code( $response );
+
+ if ( 200 !== $response_code ) {
+ return new WP_Error(
+ 'github_api_error',
+ sprintf(
+ /* translators: %1$d: HTTP response code, %2$s: Response message */
+ __( 'GitHub API error (HTTP %1$d): %2$s', 'stellar-changelog-embed' ),
+ $response_code,
+ wp_remote_retrieve_response_message( $response )
+ )
+ );
+ }
+
+ // Return the response body.
+ return wp_remote_retrieve_body( $response );
+ }
+}
diff --git a/src/ChangelogEmbed/Helper.php b/src/ChangelogEmbed/Helper.php
new file mode 100644
index 0000000..7ee01a6
--- /dev/null
+++ b/src/ChangelogEmbed/Helper.php
@@ -0,0 +1,60 @@
+ __( 'Additions', 'stellar-changelog-embed' ),
+ __( 'Change', 'stellar-changelog-embed' ) => __( 'Changes', 'stellar-changelog-embed' ),
+ __( 'Deprecation', 'stellar-changelog-embed' ) => __( 'Deprecations', 'stellar-changelog-embed' ),
+ __( 'Enhancement', 'stellar-changelog-embed' ) => __( 'Enhancements', 'stellar-changelog-embed' ),
+ __( 'Feature', 'stellar-changelog-embed' ) => __( 'Features', 'stellar-changelog-embed' ),
+ __( 'Fix', 'stellar-changelog-embed' ) => __( 'Fixes', 'stellar-changelog-embed' ),
+ __( 'Improvement', 'stellar-changelog-embed' ) => __( 'Improvements', 'stellar-changelog-embed' ),
+ __( 'Performance', 'stellar-changelog-embed' ) => __( 'Performance', 'stellar-changelog-embed' ),
+ __( 'Removal', 'stellar-changelog-embed' ) => __( 'Removals', 'stellar-changelog-embed' ),
+ __( 'Security', 'stellar-changelog-embed' ) => __( 'Security', 'stellar-changelog-embed' ),
+ __( 'Tweak', 'stellar-changelog-embed' ) => __( 'Tweaks', 'stellar-changelog-embed' ),
+ __( 'Update', 'stellar-changelog-embed' ) => __( 'Updates', 'stellar-changelog-embed' ),
+ ];
+
+ /**
+ * Filters the plural forms for change types.
+ *
+ * @since 2.0.0
+ *
+ * @param array $plurals Array of singular => plural mappings.
+ * @param string $type The change type being pluralized.
+ *
+ * @return array Modified array of plural forms.
+ */
+ $plurals = apply_filters( 'stellar_changelog_embed_type_plurals', $plurals, $type );
+
+ // Return the predefined plural if it exists, otherwise add 's'.
+ return isset( $plurals[ $type ] )
+ ? $plurals[ $type ]
+ : $type . 's';
+ }
+}
diff --git a/src/ChangelogEmbed/Plugin.php b/src/ChangelogEmbed/Plugin.php
index 4db36c4..77cd2e2 100644
--- a/src/ChangelogEmbed/Plugin.php
+++ b/src/ChangelogEmbed/Plugin.php
@@ -1,7 +1,21 @@
$value ) {
+ $request->set_param( $key, $value );
}
- // Fetch the contents of the text file
- $response = wp_remote_get( $changelog_url );
+ $api = new API();
+ $response = $api->get_changelog( $request );
if ( is_wp_error( $response ) ) {
- return '';
+ $error_message = sprintf(
+ /* translators: %s is the error message. */
+ __( 'Error fetching changelog data: %s', 'stellar-changelog-embed' ),
+ $response->get_error_message()
+ );
+
+ ob_start();
+ include STELLAR_CHANGELOG_EMBED_DIR . '/src/views/error.php';
+ $template = (string) ob_get_clean();
+
+ return wp_kses_post( $template );
}
- $body = wp_remote_retrieve_body( $response );
+ $changelog_data = $response->get_data();
+ $versions_per_page = intval( $attributes['per_page'] ?? 5 );
- // Replace each backtick-enclosed text with a tag.
- $body = preg_replace('/`([^`]+)`/', '$1', $body );
+ ob_start();
+ include STELLAR_CHANGELOG_EMBED_DIR . '/src/views/changelog.php';
+ $template = (string) ob_get_clean();
- // Make headings tags.
- $body = preg_replace('/= \[(\d+\.\d+\.\d+)\] =/', "\n$1
", $body);
+ // Return the contents of the text file.
- // Replace each asterisk at the beginning of a line with a list item
.
- $body = preg_replace('/^\* (.+)/m', ' $1 ', $body);
+ $allowed_html = wp_kses_allowed_html( 'post' );
- // Wrap all groups of list items in an unordered list .
- $body = preg_replace('/(- .+<\/li>\n)+/', '
$0
', $body);
+ $allowed_html = wp_parse_args(
+ $allowed_html,
+ [
+ 'div' => [],
+ ]
+ );
- // Return the contents of the text file.
- return wp_kses_post( $body );
+ $allowed_html['div'] = wp_parse_args(
+ $allowed_html['div'],
+ [
+ 'data-type' => true,
+ 'data-page' => true,
+ 'data-total-versions' => true,
+ 'data-version-index' => true,
+ 'data-version' => true,
+ 'data-versions-per-page' => true,
+ ]
+ );
+
+ return wp_kses(
+ $template,
+ $allowed_html
+ );
}
}
diff --git a/src/ChangelogEmbed/Settings.php b/src/ChangelogEmbed/Settings.php
new file mode 100644
index 0000000..2cbf01e
--- /dev/null
+++ b/src/ChangelogEmbed/Settings.php
@@ -0,0 +1,385 @@
+ 'string',
+ 'sanitize_callback' => 'sanitize_text_field',
+ 'default' => '',
+ ]
+ );
+
+ // Add settings section.
+ add_settings_section(
+ 'stellar_changelog_embed_github_section',
+ __( 'GitHub Configuration', 'stellar-changelog-embed' ),
+ '',
+ 'stellar-changelog-embed'
+ );
+
+ // Add settings field.
+ add_settings_field(
+ 'stellar_changelog_embed_github_token',
+ __( 'GitHub API Token', 'stellar-changelog-embed' ),
+ [ $this, 'render_github_token_field' ],
+ 'stellar-changelog-embed',
+ 'stellar_changelog_embed_github_section',
+ [
+ 'label_for' => 'stellar_changelog_embed_github_token',
+ 'description' => sprintf(
+ /* translators: %s: URL to GitHub API token settings */
+ __( 'Enter a GitHub API personal access token to increase API rate limits and access private repositories. You can create one %s.', 'stellar-changelog-embed' ),
+ '' . __( 'here', 'stellar-changelog-embed' ) . ''
+ ) .
+ '' .
+ '- ' . __( 'Fine-grained personal access tokens: You will need the
Contents scope set to Read-only.', 'stellar-changelog-embed' ) . ' ' .
+ '- ' . __( 'Classic personal access tokens: The full
repo scope is required for private repositories. If only public repositories are needed, the public_repo scope is sufficient.', 'stellar-changelog-embed' ) . ' ' .
+ '
',
+ ]
+ );
+ }
+
+ /**
+ * Render the GitHub API token field.
+ *
+ * @since 2.0.0
+ *
+ * @param array $args The arguments for the field.
+ *
+ * @return void
+ */
+ public function render_github_token_field( $args ): void {
+ $value = (string) get_option( 'stellar_changelog_embed_github_token', '' );
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ render_cache_management_section(); ?>
+
+ get_cache_duration();
+ $cache_hours = $cache_duration / HOUR_IN_SECONDS;
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+ ' . esc_html( number_format( $cache_hours, 1 ) ) . '
'
+ );
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+ add_filter('stellar_changelog_embed_cache_duration', function($duration) {
+ return 6 * HOUR_IN_SECONDS; // 6 hours instead of default 1 hour
+ });
+
+
+
+
+
+
+ get_cache_duration();
+ $cache_hours = $cache_duration / HOUR_IN_SECONDS;
+ ?>
+
+ __( 'Security check failed.', 'stellar-changelog-embed' ),
+ )
+ );
+ }
+
+ // Check user capabilities.
+ if ( ! current_user_can( 'manage_options' ) ) {
+ wp_send_json_error(
+ array(
+ 'error' => __( 'You do not have permission to perform this action.', 'stellar-changelog-embed' ),
+ )
+ );
+ }
+
+ // Clear the cache.
+ $cache = new Cache();
+ $cleared = $cache->clear_all();
+
+ if ( $cleared > 0 ) {
+ wp_send_json_success(
+ array(
+ 'message' => sprintf(
+ /* translators: %d: Number of cache items cleared */
+ _n(
+ '%d cache item cleared successfully.',
+ '%d cache items cleared successfully.',
+ $cleared,
+ 'stellar-changelog-embed'
+ ),
+ $cleared
+ ),
+ )
+ );
+ }
+
+ wp_send_json_success(
+ array(
+ 'message' => __( 'No cached items found to clear.', 'stellar-changelog-embed' ),
+ )
+ );
+ }
+}
diff --git a/src/modules/blocks/changelog-embed/block.json b/src/modules/blocks/changelog-embed/block.json
index c3407e0..501fab2 100644
--- a/src/modules/blocks/changelog-embed/block.json
+++ b/src/modules/blocks/changelog-embed/block.json
@@ -3,23 +3,47 @@
"apiVersion": 3,
"name": "stellarwp/changelog-embed",
"version": "0.1.0",
- "title": "Stellar Changelog Embed",
+ "title": "StellarWP Changelog Embed",
"category": "embed",
"icon": "text",
- "description": "Embed a changelog text file as content.",
+ "description": "Embed a StellarWP changelog text file as content.",
"example": {},
"supports": {
"html": false
},
"keywords": [
- "64756b"
+ "stellarwp",
+ "changelog",
+ "embed"
],
"attributes": {
- "changelogUrl": {
+ "owner": {
+ "type": "string",
+ "default": "stellarwp"
+ },
+ "repo": {
"type": "string",
"default": ""
+ },
+ "path": {
+ "type": "string",
+ "default": "changelog.txt"
+ },
+ "branch": {
+ "type": "string",
+ "default": "main"
+ },
+ "max_versions": {
+ "type": "integer",
+ "default": 5
+ },
+ "per_page": {
+ "type": "integer",
+ "default": 5
}
},
"textdomain": "stellarwp-changelog-embed",
- "editorScript": "file:./index.js"
+ "editorScript": "file:./index.js",
+ "style": "file:./style-index.css",
+ "viewScript": [ "jquery", "file:./frontend.js" ]
}
diff --git a/src/modules/blocks/changelog-embed/edit.js b/src/modules/blocks/changelog-embed/edit.js
index d8cacac..a11c805 100644
--- a/src/modules/blocks/changelog-embed/edit.js
+++ b/src/modules/blocks/changelog-embed/edit.js
@@ -4,9 +4,10 @@
* @see https://developer.wordpress.org/block-editor/reference-guides/packages/packages-i18n/
*/
import { InspectorControls, useBlockProps } from '@wordpress/block-editor';
-import { TextControl } from '@wordpress/components';
+import { TextControl, PanelBody } from '@wordpress/components';
import { Fragment } from '@wordpress/element';
import ServerSideRender from '@wordpress/server-side-render';
+import { __ } from '@wordpress/i18n';
/**
* The edit function describes the structure of your block in the context of the
@@ -23,27 +24,62 @@ export default function Edit(props) {
let changelogUrlInfo = null;
if ( ! attributes.changelogUrl ) {
- changelogUrlInfo = (Set the changelog URL in the sidebar.);
+ changelogUrlInfo = ({__("Configure in the sidebar. This box is not visible in the frontend.", "stellar-changelog-embed")});
} else {
changelogUrlInfo = ({attributes.changelogUrl});
}
- return (
+ return (
-
+
setAttributes({ changelogUrl: newUrl })}
- help="Enter the URL of the changelog file you want to display."
+ label={__("Owner", "stellar-changelog-embed")}
+ value={attributes.owner}
+ onChange={(newOwner) => setAttributes({ owner: newOwner })}
+ placeholder="stellarwp"
/>
-
+
+ setAttributes({ repo: newRepo })}
+ placeholder="stellar-changelog-embed"
+ />
+
+ setAttributes({ path: newPath })}
+ placeholder="changelog.txt"
+ />
+
+ setAttributes({ branch: newBranch })}
+ placeholder="main"
+ />
+
+ setAttributes({ max_versions: parseInt(newMaxVersions) || 5 })}
+ />
+
+ setAttributes({ per_page: parseInt(newPerPage) || 5 })}
+ />
+
- Changelog Embed (this box is not visible in the frontend)
+ {__("Changelog Embed", "stellar-changelog-embed")}
{changelogUrlInfo}
diff --git a/src/modules/blocks/changelog-embed/frontend.js b/src/modules/blocks/changelog-embed/frontend.js
new file mode 100644
index 0000000..1a0a482
--- /dev/null
+++ b/src/modules/blocks/changelog-embed/frontend.js
@@ -0,0 +1,266 @@
+/**
+ * Frontend JavaScript for Changelog Viewer.
+ *
+ * Handles toggling of changelog versions, sections, and pagination.
+ *
+ * @since 2.0.0
+ *
+ * @param {jQuery} $ The jQuery object.
+ *
+ * @return {void}
+ */
+(function($) {
+ 'use strict';
+
+ /**
+ * Initialize the changelog functionality.
+ *
+ * @since 2.0.0
+ *
+ * @return {void}
+ */
+ function initChangelog() {
+ // Initialize pagination for each changelog viewer.
+ $('.stellar-changelog-embed').each(function() {
+ initPagination($(this));
+ });
+
+ // Handle version header clicks.
+ $('.stellar-changelog-embed__toggle').on('click touch', function() {
+ const $header = $(this).closest('.stellar-changelog-embed__version-header');
+ const $version = $header.closest('.stellar-changelog-embed__version');
+ const $content = $version.find('.stellar-changelog-embed__version-content');
+ const $toggle = $(this);
+
+ // Toggle display.
+ $content.slideToggle(200);
+
+ // Update aria attributes.
+ const isExpanded = $toggle.attr('aria-expanded') === 'true';
+ $toggle.attr('aria-expanded', !isExpanded);
+
+ // Store expanded state in browser storage.
+ const version = $header.data('version');
+ if (version) {
+ const expandedVersions = getExpandedVersions();
+
+ if (isExpanded) {
+ // Remove from expanded versions.
+ const index = expandedVersions.indexOf(version);
+ if (index !== -1) {
+ expandedVersions.splice(index, 1);
+ }
+ } else {
+ // Add to expanded versions.
+ if (!expandedVersions.includes(version)) {
+ expandedVersions.push(version);
+ }
+ }
+
+ // Save updated list.
+ saveExpandedVersions(expandedVersions);
+ }
+ });
+
+ // Handle section header clicks.
+ $('.stellar-changelog-embed__section-count').on('click touch', function() {
+ const $header = $(this).closest('.stellar-changelog-embed__section-header');
+ const $section = $header.closest('.stellar-changelog-embed__section');
+ const $changes = $section.find('.stellar-changelog-embed__changes');
+
+ // Toggle display.
+ $changes.slideToggle(200);
+
+ // Toggle aria attribute.
+ const isExpanded = $(this).attr('aria-expanded') === 'true';
+ $(this).attr('aria-expanded', !isExpanded);
+ });
+
+ // Set initial states based on stored preferences.
+ restoreExpandedVersions();
+ }
+
+ /**
+ * Initialize pagination for a changelog viewer.
+ *
+ * @since 2.0.0
+ *
+ * @param {jQuery} $viewer The changelog viewer element.
+ *
+ * @return void
+ */
+ function initPagination($viewer) {
+ const versionsPerPage = parseInt($viewer.data('versions-per-page')) || 5;
+ const totalVersions = parseInt($viewer.data('total-versions')) || 0;
+
+ if (totalVersions <= versionsPerPage) {
+ return; // No pagination needed.
+ }
+
+ $viewer.data('current-page', 1);
+ const totalPages = Math.ceil(totalVersions / versionsPerPage);
+
+ // Show first page initially.
+ showPage($viewer, 1, versionsPerPage);
+
+ // Handle pagination button clicks.
+ $viewer.on('click', '.stellar-changelog-embed__pagination-btn', function(e) {
+ e.preventDefault();
+ const $btn = $(this);
+
+ if ($btn.prop('disabled')) {
+ return;
+ }
+
+ if ($btn.hasClass('stellar-changelog-embed__pagination-btn--prev')) {
+ $viewer.data('current-page', Math.max(1, $viewer.data('current-page') - 1));
+ } else if ($btn.hasClass('stellar-changelog-embed__pagination-btn--next')) {
+ $viewer.data('current-page', Math.min(totalPages, $viewer.data('current-page') + 1));
+ } else if ($btn.hasClass('stellar-changelog-embed__pagination-btn--number')) {
+ $viewer.data('current-page', parseInt($btn.data('page')));
+ }
+
+ showPage($viewer, $viewer.data('current-page'), versionsPerPage);
+ updatePaginationControls($viewer, $viewer.data('current-page'), totalPages);
+
+ // Scroll to top of changelog.
+ $viewer[0].scrollIntoView({ behavior: 'smooth', block: 'start' });
+ });
+ }
+
+ /**
+ * Show specific page of changelog versions.
+ *
+ * @since 2.0.0
+ *
+ * @param {jQuery} $viewer The changelog viewer element.
+ * @param {number} page The page number to show.
+ * @param {number} versionsPerPage Number of versions per page.
+ *
+ * @return void
+ */
+ function showPage($viewer, page, versionsPerPage) {
+ const $versions = $viewer.find('.stellar-changelog-embed__version');
+ const startIndex = (page - 1) * versionsPerPage;
+ const endIndex = startIndex + versionsPerPage;
+
+ $versions.each(function(index) {
+ const $version = $(this);
+ if (index >= startIndex && index < endIndex) {
+ $version.show();
+ } else {
+ $version.hide();
+ }
+ });
+
+ // Update pagination info.
+ const $paginationText = $viewer.find('.stellar-changelog-embed__current-page');
+ if ($paginationText.length) {
+ $paginationText.text(page);
+ }
+ }
+
+ /**
+ * Update pagination controls state
+ *
+ * @since 2.0.0
+ *
+ * @param {jQuery} $viewer The changelog viewer element.
+ * @param {number} currentPage Current page number.
+ * @param {number} totalPages Total number of pages.
+ *
+ * @return void
+ */
+ function updatePaginationControls($viewer, currentPage, totalPages) {
+ const $prevBtn = $viewer.find('.stellar-changelog-embed__pagination-btn--prev');
+ const $nextBtn = $viewer.find('.stellar-changelog-embed__pagination-btn--next');
+ const $numberBtns = $viewer.find('.stellar-changelog-embed__pagination-btn--number');
+
+ // Update prev/next buttons.
+ $prevBtn.prop('disabled', currentPage <= 1);
+ $nextBtn.prop('disabled', currentPage >= totalPages);
+
+ // Update number buttons.
+ $numberBtns.removeClass('active').removeAttr('aria-current');
+ $numberBtns.filter(`[data-page="${currentPage}"]`).addClass('active').attr('aria-current', 'page');
+ }
+
+ /**
+ * Get array of expanded version numbers from localStorage.
+ *
+ * @since 2.0.0
+ *
+ * @return {Array} List of expanded version numbers.
+ *
+ * @return void
+ */
+ function getExpandedVersions() {
+ try {
+ const stored = localStorage.getItem('stellar_changelog_embed_expanded');
+ return stored ? JSON.parse(stored) : [];
+ } catch (e) {
+ console.error('Error reading changelog preferences', e);
+ return [];
+ }
+ }
+
+ /**
+ * Save array of expanded version numbers to localStorage.
+ *
+ * @since 2.0.0
+ *
+ * @param {Array} versions List of expanded version numbers.
+ *
+ * @return void
+ */
+ function saveExpandedVersions(versions) {
+ try {
+ localStorage.setItem('stellar_changelog_embed_expanded', JSON.stringify(versions));
+ } catch (e) {
+ console.error('Error saving changelog preferences', e);
+ }
+ }
+
+ /**
+ * Restore expanded state of versions from localStorage.
+ *
+ * @since 2.0.0
+ *
+ * @return void
+ */
+ function restoreExpandedVersions() {
+ const expandedVersions = getExpandedVersions();
+
+ // First collapse all versions (except the latest if no preferences exist).
+ $('.stellar-changelog-embed__version:visible').each(function(index) {
+ const $version = $(this);
+ const $header = $version.find('.stellar-changelog-embed__version-header');
+ const $content = $version.find('.stellar-changelog-embed__version-content');
+ const $toggle = $header.find('.stellar-changelog-embed__toggle');
+ const version = $header.data('version');
+
+ // Determine if this version should be expanded.
+ let shouldBeExpanded;
+
+ if (expandedVersions.length > 0) {
+ // Use stored preferences.
+ shouldBeExpanded = expandedVersions.includes(version);
+ } else {
+ // Default: only expand latest version (first visible one).
+ shouldBeExpanded = index === 0;
+ }
+
+ // Set initial state.
+ if (!shouldBeExpanded) {
+ $content.hide();
+ $toggle.attr('aria-expanded', 'false');
+ }
+ });
+ }
+
+ // Initialize when DOM is fully loaded.
+ $(document).ready(function() {
+ initChangelog();
+ });
+
+})(jQuery);
diff --git a/src/modules/blocks/changelog-embed/index.js b/src/modules/blocks/changelog-embed/index.js
index 090c9f2..04d8939 100644
--- a/src/modules/blocks/changelog-embed/index.js
+++ b/src/modules/blocks/changelog-embed/index.js
@@ -11,6 +11,9 @@ import { registerBlockType } from '@wordpress/blocks';
import Edit from './edit';
import metadata from './block.json';
+// Ensures the CSS is built.
+import './style.css';
+
/**
* Every block starts by registering a new block type definition.
*
diff --git a/src/modules/blocks/changelog-embed/style.css b/src/modules/blocks/changelog-embed/style.css
new file mode 100644
index 0000000..620ecf5
--- /dev/null
+++ b/src/modules/blocks/changelog-embed/style.css
@@ -0,0 +1,428 @@
+/**
+ * Changelog Viewer Styles
+ */
+
+.stellar-changelog-embed {
+ max-width: 100%;
+ margin: 0 auto;
+ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen-Sans, Ubuntu, Cantarell, "Helvetica Neue", sans-serif;
+ color: #333;
+}
+
+.stellar-changelog-embed__pagination-info {
+ color: #64748b;
+ font-size: 0.875rem;
+}
+
+.stellar-changelog-embed__pagination-info .current-page {
+ font-weight: 600;
+ color: #1e40af;
+}
+
+.stellar-changelog-embed__versions {
+ margin-top: 1rem;
+}
+
+/* Version container */
+.stellar-changelog-embed__version {
+ margin-bottom: 2rem;
+ border: 1px solid #e2e8f0;
+ border-radius: 0.375rem;
+ box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+ overflow: hidden;
+}
+
+/* Version header */
+.stellar-changelog-embed__version-header {
+ padding: 1rem;
+ background-color: #f8fafc;
+ border-bottom: 1px solid #e2e8f0;
+ display: flex;
+ justify-content: space-between;
+ align-items: center;
+}
+
+.stellar-changelog-embed__version-info {
+ display: flex;
+ align-items: center;
+ flex-wrap: wrap;
+ gap: 0.5rem;
+}
+
+.stellar-changelog-embed__version-info .stellar-changelog-embed__version-title {
+ margin: 0;
+ font-size: 1.25rem;
+ font-weight: 600;
+ color: #1a202c;
+}
+
+.stellar-changelog-embed__version-date {
+ color: #64748b;
+ font-size: 0.875rem;
+ display: flex;
+ align-items: center;
+}
+
+.stellar-changelog-embed__version-date::before {
+ content: '';
+ display: inline-block;
+ width: 16px;
+ height: 16px;
+ margin-right: 0.25rem;
+ background-image: url('data:image/svg+xml;utf8,');
+ background-repeat: no-repeat;
+ background-position: center;
+}
+
+.stellar-changelog-embed__version-tag {
+ display: inline-block;
+ padding: 0.25rem 0.5rem;
+ border-radius: 9999px;
+ font-size: 0.75rem;
+ font-weight: 500;
+ text-transform: uppercase;
+}
+
+.stellar-changelog-embed__version-latest {
+ background-color: #ebf5ff;
+ color: #1e40af;
+}
+
+.stellar-changelog-embed__toggle {
+ background: transparent;
+ border: none;
+ cursor: pointer;
+ padding: 0.5rem;
+ color: #64748b;
+ transition: transform 0.2s;
+}
+
+.stellar-changelog-embed__toggle:focus {
+ outline: none;
+ box-shadow: 0 0 0 2px rgba(66, 153, 225, 0.5);
+}
+
+.stellar-changelog-embed__toggle-icon {
+ display: block;
+ width: 14px;
+ height: 14px;
+ position: relative;
+}
+
+.stellar-changelog-embed__toggle-icon::before,
+.stellar-changelog-embed__toggle-icon::after {
+ content: '';
+ position: absolute;
+ background-color: currentColor;
+ transition: transform 0.2s;
+}
+
+.stellar-changelog-embed__toggle-icon::before {
+ top: 6px;
+ left: 0;
+ width: 14px;
+ height: 2px;
+}
+
+.stellar-changelog-embed__toggle-icon::after {
+ top: 0;
+ left: 6px;
+ width: 2px;
+ height: 14px;
+}
+
+.stellar-changelog-embed__toggle[aria-expanded="true"] .stellar-changelog-embed__toggle-icon::after {
+ transform: rotate(90deg);
+}
+
+/* Version content */
+.stellar-changelog-embed__version-content {
+ padding: 1rem;
+ background-color: #fff;
+}
+
+/* Sections (grouped by type) */
+.stellar-changelog-embed__section {
+ margin-bottom: 1.5rem;
+ border: 1px solid #e2e8f0;
+ border-radius: 0.25rem;
+ overflow: hidden;
+}
+
+.stellar-changelog-embed__section:last-child {
+ margin-bottom: 0;
+}
+
+.stellar-changelog-embed__section-header {
+ margin: 0;
+ padding: 0.75rem 1rem;
+ background-color: #f8fafc;
+ font-size: 1rem;
+ font-weight: 600;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ user-select: none;
+}
+
+.stellar-changelog-embed__section-title {
+ display: flex;
+ align-items: center;
+ gap: 0.5rem;
+ color: #2d3748;
+}
+
+.stellar-changelog-embed__section-count {
+ background-color: #e2e8f0;
+ color: #4a5568;
+ font-size: 0.75rem;
+ font-weight: 600;
+ padding: 0.125rem 0.375rem;
+ border-radius: 9999px;
+ min-width: 1.5rem;
+ text-align: center;
+}
+
+/* Change list */
+.stellar-changelog-embed__changes {
+ margin: 0;
+ padding: 1rem;
+ list-style-type: none;
+}
+
+.stellar-changelog-embed__change {
+ position: relative;
+ padding-left: 1rem;
+ margin-bottom: 0.75rem;
+ line-height: 1.5;
+}
+
+.stellar-changelog-embed__change:last-child {
+ margin-bottom: 0;
+}
+
+.stellar-changelog-embed__change::before {
+ content: '';
+ position: absolute;
+ left: 0;
+ top: 0.65rem;
+ width: 6px;
+ height: 6px;
+ border-radius: 50%;
+ background-color: #a0aec0;
+}
+
+/* Type-specific colors */
+.stellar-changelog-embed__section[data-type="Fix"] .stellar-changelog-embed__section-header {
+ background-color: #fee2e2;
+}
+
+.stellar-changelog-embed__section[data-type="Fix"] .stellar-changelog-embed__section-title {
+ color: #991b1b;
+}
+
+.stellar-changelog-embed__section[data-type="Fix"] .stellar-changelog-embed__section-count {
+ background-color: #fecaca;
+ color: #b91c1c;
+}
+
+.stellar-changelog-embed__section[data-type="Tweak"] .stellar-changelog-embed__section-header {
+ background-color: #dcfce7;
+}
+
+.stellar-changelog-embed__section[data-type="Tweak"] .stellar-changelog-embed__section-title {
+ color: #166534;
+}
+
+.stellar-changelog-embed__section[data-type="Tweak"] .stellar-changelog-embed__section-count {
+ background-color: #bbf7d0;
+ color: #15803d;
+}
+
+.stellar-changelog-embed__section[data-type="Feature"] .stellar-changelog-embed__section-header {
+ background-color: #e0e7ff;
+}
+
+.stellar-changelog-embed__section[data-type="Feature"] .stellar-changelog-embed__section-title {
+ color: #3730a3;
+}
+
+.stellar-changelog-embed__section[data-type="Feature"] .stellar-changelog-embed__section-count {
+ background-color: #c7d2fe;
+ color: #4338ca;
+}
+
+.stellar-changelog-embed__section[data-type="Security"] .stellar-changelog-embed__section-header {
+ background-color: #fef3c7;
+}
+
+.stellar-changelog-embed__section[data-type="Security"] .stellar-changelog-embed__section-title {
+ color: #92400e;
+}
+
+.stellar-changelog-embed__section[data-type="Security"] .stellar-changelog-embed__section-count {
+ background-color: #fde68a;
+ color: #b45309;
+}
+
+/* Error messages */
+.stellar-changelog-embed__error {
+ padding: 1rem;
+ border-left: 4px solid #ef4444;
+ background-color: #fee2e2;
+ color: #b91c1c;
+ margin-bottom: 1rem;
+}
+
+/* Code formatting */
+.stellar-changelog-embed__change .stellar-changelog-embed__code {
+ background-color: #f1f5f9;
+ padding: 0.125rem 0.375rem;
+ border-radius: 0.25rem;
+ font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+ font-size: 0.875em;
+ color: #e11d48;
+ border: 1px solid #e2e8f0;
+ white-space: nowrap;
+ overflow-wrap: break-word;
+ word-break: break-all;
+}
+
+/* Mobile responsive code blocks */
+@media (max-width: 768px) {
+ .stellar-changelog-embed__change code {
+ white-space: normal;
+ word-break: break-all;
+ overflow-wrap: anywhere;
+ line-height: 1.4;
+ }
+}
+
+.stellar-changelog-embed__change .stellar-changelog-embed__code--multiline {
+ display: block;
+ word-break: break-all;
+ overflow-wrap: break-word;
+ word-break: break-all;
+}
+
+/* Bold and italic formatting */
+.stellar-changelog-embed__change strong {
+ font-weight: 600;
+}
+
+.stellar-changelog-embed__change em {
+ font-style: italic;
+}
+
+/* Editor specific styles */
+.stellar-changelog-embed__editor .stellar-changelog-embed__preview-note {
+ background-color: #f0f9ff;
+ border-left: 4px solid #0ea5e9;
+ padding: 0.75rem;
+ margin-bottom: 1rem;
+ font-style: italic;
+ color: #0369a1;
+}
+
+/* Responsive adjustments */
+@media (max-width: 600px) {
+ .stellar-changelog-embed__version-header {
+ flex-direction: column;
+ align-items: flex-start;
+ }
+
+ .stellar-changelog-embed__toggle {
+ position: absolute;
+ top: 1rem;
+ right: 1rem;
+ }
+
+ .stellar-changelog-embed__version-info {
+ padding-right: 2rem;
+ }
+
+ .stellar-changelog-embed__header {
+ flex-direction: column;
+ align-items: flex-start;
+ }
+
+ .stellar-changelog-embed__pagination-controls {
+ flex-direction: column;
+ gap: 0.75rem;
+ }
+
+ .stellar-changelog-embed__pagination-numbers {
+ order: -1;
+ }
+}
+
+/* Pagination styles */
+.stellar-changelog-embed__pagination {
+ margin-top: 2rem;
+ padding-top: 1.5rem;
+ border-top: 1px solid #e2e8f0;
+}
+
+.stellar-changelog-embed__pagination-controls {
+ list-style: none;
+ margin: 0;
+ padding: 0;
+ align-items: center;
+ display: flex;
+ gap: 1rem;
+ justify-content: center;
+}
+
+.stellar-changelog-embed__pagination-controls li {
+ display: inline-block;
+ list-style-type: none;
+}
+
+.stellar-changelog-embed__pagination-btn {
+ background: #ffffff;
+ border: 1px solid #d1d5db;
+ border-radius: 0.375rem;
+ padding: 0.5rem 0.75rem;
+ cursor: pointer;
+ font-size: 0.875rem;
+ font-weight: 500;
+ color: #374151;
+ transition: all 0.2s;
+ min-width: 2.5rem;
+ height: 2.5rem;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ text-decoration: none;
+}
+
+.stellar-changelog-embed__pagination-btn:hover:not(:disabled) {
+ background-color: #f9fafb;
+ border-color: #9ca3af;
+ color: #111827;
+}
+
+.stellar-changelog-embed__pagination-btn:focus {
+ outline: none;
+ box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.5);
+ color: #111827;
+}
+
+.stellar-changelog-embed__pagination-btn:disabled {
+ opacity: 0.5;
+ cursor: not-allowed;
+ color: #9ca3af;
+}
+
+.stellar-changelog-embed__pagination-btn.active {
+ background-color: #3b82f6;
+ border-color: #3b82f6;
+ color: #ffffff !important;
+ font-weight: 600;
+}
+
+.stellar-changelog-embed__pagination-btn.active:hover {
+ background-color: #2563eb;
+ border-color: #2563eb;
+ color: #ffffff !important;
+}
diff --git a/src/views/changelog.php b/src/views/changelog.php
new file mode 100644
index 0000000..1456f3e
--- /dev/null
+++ b/src/views/changelog.php
@@ -0,0 +1,241 @@
+
+
+
+
+
+
diff --git a/src/views/error.php b/src/views/error.php
new file mode 100644
index 0000000..1347542
--- /dev/null
+++ b/src/views/error.php
@@ -0,0 +1,17 @@
+
+