Feature: adds support for alternate WP styles (#3)

Author: JasonTheAdams

README.md

@@ -366,6 +366,58 @@ $notice = AdminNotices::show('my_notice', 'This is a notice')
     ->urgency($urgency);
 ```
 
+### `alternateStyles($useAlternate)`, `standardStyles()`
+
+**Default:** false
+
+Sets whether the notice should use the alternate WordPress notice styles. **Only works when the
+wrapper is enabled.**
+
+Parameters:
+
+1. `bool $useAlternate = true` - Whether the notice should use the alternate WordPress notice
+   styles
+
+```php
+use StellarWP\AdminNotices\AdminNotices;
+
+// Use the alternate WordPress notice styles
+$notice = AdminNotices::show('my_notice', 'This is a notice')
+    ->alternateStyles();
+
+// Use the standard WordPress notice styles, only necessary to revert back
+$notice = AdminNotices::show('my_notice', 'This is a notice')
+    ->alternateStyles()
+    ->standardStyles();
+```
+
+### `inline($inline)`, `notInline()`
+
+**Default:** false
+
+Sets whether the notice should be displayed in the WP "inline" location, at the top of the admin
+page. **Only works when the wrapper is enabled.**
+
+Parameters:
+
+1. `bool $inline = true` - Whether the notice should be displayed inline
+
+```php
+use StellarWP\AdminNotices\AdminNotices;
+
+// Display the notice inline
+$notice = AdminNotices::show('my_notice', 'This is a notice')
+    ->inline();
+
+// Display the notice in the standard location
+$notice = AdminNotices::show('my_notice', 'This is a notice')
+    ->inline(false);
+
+// Also has an alias for readability
+$notice = AdminNotices::show('my_notice', 'This is a notice')
+    ->notInline();
+```
+
 ### `dismissible($dismissible)`, `notDismissible()`
 
 **Default:** false

src/Actions/RenderAdminNotice.php

@@ -56,6 +56,10 @@ private function getWrapperClasses(AdminNotice $notice): string
             $classes[] = 'inline';
         }
 
+        if ($notice->usesAlternateStyles()) {
+            $classes[] = 'notice-alt';
+        }
+
         return implode(' ', $classes);
     }
 }

src/AdminNotice.php

@@ -60,6 +60,11 @@ class AdminNotice
      */
     protected $urgency;
 
+    /**
+     * @var bool
+     */
+    protected $alternateStyles = false;
+
     /**
      * @var bool
      */
@@ -238,26 +243,80 @@ public function urgency($urgency): self
         return $this;
     }
 
+    /**
+     * Alias for setting the urgency to info
+     *
+     * @since 1.1.0
+     */
     public function asInfo(): self
     {
         return $this->urgency(NoticeUrgency::info());
     }
 
+    /**
+     * Alias for setting the urgency to success
+     *
+     * @since 1.1.0
+     */
     public function asSuccess(): self
     {
         return $this->urgency(NoticeUrgency::success());
     }
 
+    /**
+     * Alias for setting the urgency to warning
+     *
+     * @since 1.1.0
+     */
     public function asWarning(): self
     {
         return $this->urgency(NoticeUrgency::warning());
     }
 
+    /**
+     * Alias for setting the urgency to error
+     *
+     * @since 1.1.0
+     */
     public function asError(): self
     {
         return $this->urgency(NoticeUrgency::error());
     }
 
+    /**
+     * Uses the alternate WP notice styles
+     *
+     * @unreleased
+     */
+    public function alternateStyles(bool $altStyle = true): self
+    {
+        $this->alternateStyles = $altStyle;
+
+        return $this;
+    }
+
+    /**
+     * Uses the standard WP notice styles
+     *
+     * @unreleased
+     */
+    public function standardStyles(): self
+    {
+        $this->alternateStyles = false;
+
+        return $this;
+    }
+
+    /**
+     * Returns whether the notice uses the alternate WP notice styles
+     *
+     * @unreleased
+     */
+    public function usesAlternateStyles(): bool
+    {
+        return $this->alternateStyles;
+    }
+
     /**
      * Sets the notice to display without the standard WordPress wrapper
      *

tests/unit/Actions/DisplayNoticesInAdminTest.php

@@ -21,7 +21,7 @@ class DisplayNoticesInAdminTest extends TestCase
     protected $originalServer;
 
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     protected function setUp(): void
     {
@@ -30,7 +30,7 @@ protected function setUp(): void
     }
 
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     protected function tearDown(): void
     {
@@ -39,7 +39,7 @@ protected function tearDown(): void
     }
 
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     public function testShouldEchoNothingWithNoNotices(): void
     {
@@ -50,7 +50,7 @@ public function testShouldEchoNothingWithNoNotices(): void
     }
 
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     public function testShouldAcceptMultipleNotices(): void
     {
@@ -66,7 +66,7 @@ public function testShouldAcceptMultipleNotices(): void
      * @covers ::passesDateLimits
      * @dataProvider passDateLimitsDataProvider
      *
-     * @unreleased
+     * @since 1.0.0
      */
     public function testPassesDateLimits(AdminNotice $notice, bool $shouldPass): void
     {
@@ -104,7 +104,7 @@ public function passDateLimitsDataProvider(): array
      * @dataProvider passWhenCallbackDataProvider
      * @covers ::passesWhenCallback
      *
-     * @unreleased
+     * @since 1.0.0
      */
     public function testPassesWhenCallback(AdminNotice $notice, bool $shouldPass): void
     {
@@ -120,7 +120,7 @@ public function testPassesWhenCallback(AdminNotice $notice, bool $shouldPass): v
     }
 
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     public function passWhenCallbackDataProvider(): array
     {
@@ -145,7 +145,7 @@ public function passWhenCallbackDataProvider(): array
      * @dataProvider passUserCapabilitiesDataProvider
      * @covers ::passesUserCapabilities
      *
-     * @unreleased
+     * @since 1.0.0
      */
     public function testPassesUserCapabilities(AdminNotice $notice, bool $shouldPass): void
     {
@@ -241,7 +241,7 @@ public function testShouldPassScreenConditionsWhenConditionMatchesWPScreen(): vo
     /**
      * Produces a simple mock with predictable output.
      *
-     * @unreleased
+     * @since 1.0.0
      */
     private function getSimpleMockNotice($output): AdminNotice
     {

tests/unit/Actions/RenderAdminNoticeTest.php

@@ -9,7 +9,7 @@
 class RenderAdminNoticeTest extends TestCase
 {
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     public function testShouldRenderNoticeWithoutWrapper(): void
     {
@@ -25,7 +25,7 @@ public function testShouldRenderNoticeWithoutWrapper(): void
     /**
      * Tests the wrapper and that the default urgency is info
      *
-     * @unreleased
+     * @since 1.0.0
      */
     public function testShouldRenderNoticeInWrapper(): void
     {
@@ -42,7 +42,7 @@ public function testShouldRenderNoticeInWrapper(): void
     }
 
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     public function testShouldIncludeDismissibleClass(): void
     {
@@ -59,7 +59,7 @@ public function testShouldIncludeDismissibleClass(): void
     }
 
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     public function testShouldIncludeAutoParagraphs(): void
     {
@@ -77,7 +77,7 @@ public function testShouldIncludeAutoParagraphs(): void
     }
 
     /**
-     * @unreleased
+     * @since 1.0.0
      */
     public function testShouldRenderCallbackOutput(): void
     {