Add Basicrum branding assets

Author: Tsvetan Stoychev

plugins/basicrum/assets/css/admin/settings.css

@@ -1,3 +1,22 @@
+.basicrum-settings-header {
+	align-items: center;
+	display: flex;
+	gap: 12px;
+	margin: 20px 0;
+}
+
+.basicrum-settings-header h1 {
+	margin: 0;
+	padding: 0;
+}
+
+.basicrum-settings-logo {
+	display: block;
+	flex: 0 0 auto;
+	height: 48px;
+	width: 48px;
+}
+
 .basicrum-field-control {
 	display: inline-flex;
 	align-items: center;

plugins/basicrum/assets/images/basicrum-logo.png

@@ -415,7 +415,16 @@ public function render_settings_page() {
 		}
 		?>
 		<div class="wrap">
-			<h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
+			<div class="basicrum-settings-header">
+				<img
+					class="basicrum-settings-logo"
+					src="<?php echo esc_url( Helpers::get_asset_url( 'images/basicrum-logo.png' ) ); ?>"
+					alt=""
+					width="48"
+					height="48"
+				/>
+				<h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
+			</div>
 			<form action="options.php" method="post">
 				<?php
 				settings_fields( self::GROUP );

plugins/basicrum/src/Admin/Settings/Page.php

@@ -26,10 +26,41 @@ public function test_hidden_error_icon_has_explicit_display_rule() {
 		$this->assertStringContainsString( '.basicrum-field-error-icon[hidden]', $css );
 		$this->assertMatchesRegularExpression( '/\.basicrum-field-error-icon\[hidden\]\s*\{[^}]*display:\s*none;/s', $css );
 		$this->assertMatchesRegularExpression( '/\.basicrum-field-error-message\s*\{[^}]*color:\s*#d63638;[^}]*font-weight:\s*600;/s', $css );
+		$this->assertStringContainsString( '.basicrum-settings-header', $css );
+		$this->assertStringContainsString( '.basicrum-settings-logo', $css );
 		$this->assertStringContainsString( '.basicrum-radio-option', $css );
 		$this->assertStringContainsString( '.basicrum-consent-info', $css );
 	}
 
+	/**
+	 * Test the settings page renders the packaged Basicrum logo.
+	 */
+	public function test_settings_page_renders_brand_logo() {
+		Functions\when( 'plugins_url' )->alias(
+			function( $path ) {
+				return 'https://example.com/wp-content/plugins/basicrum/' . $path;
+			}
+		);
+		Functions\expect( 'current_user_can' )->once()->with( 'manage_options' )->andReturn( true );
+		Functions\when( 'get_admin_page_title' )->justReturn( 'Basicrum Settings' );
+		Functions\when( 'settings_fields' )->justReturn();
+		Functions\when( 'do_settings_sections' )->justReturn();
+		Functions\when( 'submit_button' )->justReturn();
+
+		$page = new Page();
+
+		ob_start();
+		$page->render_settings_page();
+		$html = ob_get_clean();
+
+		$this->assertStringContainsString( 'class="basicrum-settings-header"', $html );
+		$this->assertStringContainsString( 'class="basicrum-settings-logo"', $html );
+		$this->assertStringContainsString( 'src="https://example.com/wp-content/plugins/basicrum/assets/images/basicrum-logo.png"', $html );
+		$this->assertStringContainsString( 'alt=""', $html );
+		$this->assertStringContainsString( 'width="48"', $html );
+		$this->assertStringContainsString( 'height="48"', $html );
+	}
+
 	/**
 	 * Set up WordPress function stubs.
 	 */

plugins/basicrum/tests/unit/SettingsPageTest.php

@@ -45,6 +45,7 @@ require_entry 'basicrum/vendor/composer/installed.php'
 require_entry 'basicrum/assets/js/boomr/boomerang-1.815.60.cutting-edge.min.js'
 require_entry 'basicrum/assets/js/loaders/boomerang-loader-v15.min.js'
 require_entry 'basicrum/assets/js/loaders/consent-boomerang-loader-v1-15.min.js'
+require_entry 'basicrum/assets/images/basicrum-logo.png'
 require_entry 'basicrum/languages/basicrum.pot'
 
 if printf '%s\n' "$ARCHIVE_ENTRIES" | grep -Fqx 'basicrum/assets/js/loaders/consent-api.js'; then

tools/verify-release.sh

@@ -0,0 +1,17 @@
+# WordPress.org Plugin Directory assets
+
+These files are prepared for the Basicrum listing in the WordPress.org Plugin
+Directory. When publishing through the WordPress.org SVN repository, copy them
+to its top-level `assets/` directory, alongside `trunk/`.
+
+- `icon-128x128.png` and `icon-256x256.png` are the directory icons.
+- `banner-772x250.png` and `banner-1544x500.png` are the directory banners.
+
+The canonical source artwork is
+`plugins/basicrum/assets/images/basicrum-logo.png`, which the settings page
+uses at runtime.
+
+This directory remains outside `plugins/basicrum/`, so the release build does
+not include these WordPress.org-only files in the installable Basicrum ZIP. See
+[Plugin Assets](https://developer.wordpress.org/plugins/wordpress-org/plugin-assets/)
+for the directory requirements.