[4.0] com_banners blank state (#33269)

Author: brianteeman

administrator/components/com_banners/src/View/Banners/HtmlView.php

@@ -101,6 +101,11 @@ public function display($tpl = null): void
 		$this->filterForm    = $model->getFilterForm();
 		$this->activeFilters = $model->getActiveFilters();
 
+		if (!count($this->items) && $this->get('IsBlankSlate'))
+		{
+			$this->setLayout('blankstate');
+		}
+
 		// Check for errors.
 		if (count($errors = $this->get('Errors')))
 		{

administrator/components/com_banners/tmpl/banners/blankstate.php

@@ -0,0 +1,34 @@
+<?php
+/**
+ * @package     Joomla.Administrator
+ * @subpackage  com_banners
+ *
+ * @copyright   (C) 2021 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Language\Text;
+use Joomla\CMS\Router\Route;
+
+?>
+<form action="<?php echo Route::_('index.php?option=com_banners&view=banners'); ?>" method="post" name="adminForm" id="adminForm">
+
+	<div class="px-4 py-5 my-5 text-center">
+		<span class="fa-8x icon-bookmark banners mb-4" aria-hidden="true"></span>
+		<h1 class="display-5 fw-bold"><?php echo Text::_('COM_BANNERS_BLANKSTATE_TITLE'); ?></h1>
+		<div class="col-lg-6 mx-auto">
+			<p class="lead mb-4">
+				<?php echo Text::_('COM_BANNERS_BLANKSTATE_CONTACT'); ?>
+			</p>
+			<div class="d-grid gap-2 d-sm-flex justify-content-sm-center">
+				<a href="<?php echo Route::_('index.php?option=com_banners&view=banner&layout=edit'); ?>" class="btn btn-primary btn-lg px-4 me-sm-3"><?php echo Text::_('COM_BANNERS_BLANKSTATE_BUTTON_ADD'); ?></a>
+				<a href="https://docs.joomla.org/Special:MyLanguage/Help40:Banners" class="btn btn-outline-secondary btn-lg px-4"><?php echo Text::_('COM_BANNERS_BLANKSTATE_BUTTON_LEARNMORE'); ?></a>
+			</div>
+		</div>
+	</div>
+
+	<input type="hidden" name="task" value="">
+	<input type="hidden" name="boxchecked" value="0">
+</form>

administrator/language/en-GB/com_banners.ini

@@ -34,6 +34,10 @@ COM_BANNERS_BATCH_OPTIONS="Batch process the selected banners"
 COM_BANNERS_BATCH_TIP="If a category is selected for move/copy, any actions selected will be applied to the copied or moved banners. Otherwise, all actions are applied to the selected banners."
 COM_BANNERS_BEGIN_HINT="Begin date (yyyy-mm-dd)"
 COM_BANNERS_BEGIN_LABEL="Begin Date"
+COM_BANNERS_BLANKSTATE_BUTTON_ADD="Add your first banner"
+COM_BANNERS_BLANKSTATE_BUTTON_LEARNMORE="Learn more"
+COM_BANNERS_BLANKSTATE_CONTACT="Banners are blocks of content containing advertising information and a record of the number of times the banner has been displayed is kept. You can use this component to create and manage your banners."
+COM_BANNERS_BLANKSTATE_TITLE="No Banners have been created yet."
 COM_BANNERS_CANCEL="Cancel"
 COM_BANNERS_CLICK="Click"
 COM_BANNERS_CLIENT_EDIT="Edit Client"