diff --git a/config/listboss.php b/config/listboss.php index 2f27c33..404547d 100644 --- a/config/listboss.php +++ b/config/listboss.php @@ -50,4 +50,4 @@ 'backend' => env('LISTBOSS_BACKEND', true), -]; \ No newline at end of file +]; diff --git a/routes/api.php b/routes/api.php index beb85ff..56712c8 100644 --- a/routes/api.php +++ b/routes/api.php @@ -2,6 +2,7 @@ use Illuminate\Support\Facades\Route; use NotFound\Framework\Auth\Middleware\EnsureEmailIsVerified; +use NotFound\ListBoss\Http\Controllers\DocumentationController; use NotFound\ListBoss\Http\Controllers\ListBossController; use NotFound\ListBoss\Http\Controllers\RecipientController; @@ -23,8 +24,10 @@ [ 'prefix' => '/{locale}/app/listboss', 'middleware' => 'set-forget-locale', - ], function () { + ], + function () { Route::get('', [ListBossController::class, 'index']); + Route::get('docs', [DocumentationController::class, 'index']); Route::get('{list}', [ListBossController::class, 'status']); Route::get('{list}/{recipient}', [RecipientController::class, 'show']); } diff --git a/src/Http/Controllers/DocumentationController.php b/src/Http/Controllers/DocumentationController.php new file mode 100644 index 0000000..7f05910 --- /dev/null +++ b/src/Http/Controllers/DocumentationController.php @@ -0,0 +1,34 @@ +addBreadcrumb('Verzendingen', '/app/listboss/'); + $widget->widget->addTitle(new LayoutTitle('E-mails', 'Uitleg')); + $widget->widget->addText(new LayoutText($this->doc())); + + return $widget->response(); + } + + private function doc() + { + $doc = [ + 'Deze weergave is voornamelijk bedoeld om problemen op te sporen bij de verzending. Ontbrekende gegevens geven geen uistluitsel over de status van de verzending. Slechts als de status "dropped" is is duidelijk dat een mail niet ontvangen is.', + + 'De kolom Verzonden geeft aan of de e-mail is verzonden.', + 'De kolom Geopend geeft aan of de e-mail is geopend.', + 'De kolom Geklikt geeft aan of er op een link in de e-mail is geklikt. Dat kan zijn door een gebruiker, maar helaas worden soms ook "automatische" kliks meegeteld. In de totalen wordt daarom niet het totaal aantal kliks weergegeven, maar hoeveel ontvangers een klik hebben geregistreerd.', + ]; + + return '
'.implode('
', $doc).'
'; + } +} diff --git a/src/Http/Controllers/ListBossController.php b/src/Http/Controllers/ListBossController.php index d7c38bf..02d267e 100644 --- a/src/Http/Controllers/ListBossController.php +++ b/src/Http/Controllers/ListBossController.php @@ -5,14 +5,19 @@ use NotFound\Framework\Http\Controllers\Controller; use NotFound\Framework\Http\Requests\FormDataRequest; use NotFound\Layout\Elements\LayoutBar; +use NotFound\Layout\Elements\LayoutBarButton; +use NotFound\Layout\Elements\LayoutBreadcrumb; +use NotFound\Layout\Elements\LayoutPage; use NotFound\Layout\Elements\LayoutPager; use NotFound\Layout\Elements\LayoutSearchBox; use NotFound\Layout\Elements\LayoutText; +use NotFound\Layout\Elements\LayoutWidget; use NotFound\Layout\Elements\Table\LayoutTable; use NotFound\Layout\Elements\Table\LayoutTableColumn; use NotFound\Layout\Elements\Table\LayoutTableHeader; use NotFound\Layout\Elements\Table\LayoutTableRow; use NotFound\Layout\Helpers\LayoutWidgetHelper; +use NotFound\Layout\LayoutResponse; use NotFound\ListBoss\Helpers\Job; use NotFound\ListBoss\Helpers\ListBoss; @@ -21,10 +26,13 @@ class ListBossController extends Controller public function index() { if (! config('listboss.backend')) { - abort(500, 'ListBoss settings are not set'); + $widget = new LayoutWidgetHelper('Probleem', 'Configuratie niet correct ingesteld'); + $widget->widget->addText(new LayoutText('De configuratie voor ListBoss is niet correct ingesteld.')); + + return $widget->response(); } - $widget = new LayoutWidgetHelper('E-mails', 'Verzendingen'); + $widget = new LayoutWidgetHelper('Resultaten van verzending', 'Verzendingen'); $widget->widget->noPadding(); $widget->widget->addTable($this->selectJob()); @@ -48,30 +56,53 @@ public function status(FormDataRequest $request, int $list) 'search' => 'string|nullable', ]); + $currentPage = $validated['page'] ?? 1; + $jobResults = $job->result( sort: $validated['sort'] ?? 'opens', - page: $validated['page'] ?? 1, + page: $currentPage, query: $validated['search'] ?? null, direction: (isset($validated['asc']) && $validated['asc'] === 'true') ? 'asc' : 'desc', ); - $widget = new LayoutWidgetHelper('E-mails', 'Status: '.$jobResults->message); - $widget->widget->noPadding(); - $widget->addBreadcrumb('Verzendingen', '/app/listboss/'); + $page = new LayoutPage('Resultaten van verzending'); + $breadcrumb = new LayoutBreadcrumb(); + $breadcrumb->addHome(); + $breadcrumb->addItem('Verzendingen', '/app/listboss/'); + + $breadcrumb->addItem('Resultaat'); + $page->addBreadcrumb($breadcrumb); + if ($currentPage == 1) { + $widget = new LayoutWidget('Samenvatting resultaten', 12); + + $bar = new LayoutBar(); + $bar->removePadding(); + + $bar->addBarButton((new LayoutBarButton('Uitleg'))->setLink('/app/listboss/docs')); + + $widget->addBar($bar); + + $widget->addText(new LayoutText('Status: '.$jobResults->message)); + $widget->addText(new LayoutText('Aantal ontvangers: '.$jobResults->recipients)); + $widget->addText(new LayoutText('Aantal afgeleverd: '.$jobResults->delivered)); + $widget->addText(new LayoutText('Aantal fouten: '.$jobResults->failed)); + $widget->addText(new LayoutText('Aantal ontvangers geopend: '.$jobResults->opens)); + $widget->addText(new LayoutText('Aantal ontvangers geklikt: '.$jobResults->clicks)); + + $page->addWidget($widget); + } + + $widget = new LayoutWidget('Technische details', 12); + $widget->noPadding(); $bar = new LayoutBar(); - $widget->widget->addText(new LayoutText('Aantal ontvangers: '.$jobResults->recipients)); - $widget->widget->addText(new LayoutText('Aantal afgeleverd: '.$jobResults->delivered)); - $widget->widget->addText(new LayoutText('Aantal fouten: '.$jobResults->failed)); - $widget->widget->addText(new LayoutText('Aantal ontvangers geopend: '.$jobResults->opens)); - $widget->widget->addText(new LayoutText('Aantal ontvangers geklikt: '.$jobResults->clicks)); $pager = new LayoutPager($jobResults->recipients, 100); $bar->addPager($pager); $search = new LayoutSearchBox('Zoek e-mailadres'); $bar->addSearchBox($search); - $widget->widget->addBar($bar); + $widget->addBar($bar); $table = new LayoutTable(sort: false, delete: false, create: false); @@ -93,9 +124,12 @@ public function status(FormDataRequest $request, int $list) $table->addRow($row); } - $widget->widget->addTable($table); + $widget->addTable($table); + $page->addWidget($widget); + $response = new LayoutResponse(); + $response->addUIElement($page); - return $widget->response(); + return $response->build(); } private function selectJob(): LayoutTable