README

Nova Google Analytics Cards

Stay on top of your website's performance with the Google Analytics Insights Package for Laravel Nova. This powerful integration empowers you to seamlessly integrate Google Analytics data directly into your Nova dashboard, offering you a comprehensive and real-time overview of your website's key metrics.

Requirements

• php ^8.1|^8.2|^8.3
• laravel/framework ^10.0|^11.0

Version Compatibility

Installation

You can install the package via composer:

composer require the-3labs-team/nova-google-analytics-cards

You can publish the config file with:

php artisan vendor:publish

and choose: The3LabsTeam\NovaGoogleAnalyticsCards\NovaGoogleAnalyticsCardsServiceProvider.

You can publish the Google Analytics config file with:

php artisan vendor:publish

and select: Spatie\Analytics\AnalyticsServiceProvider.

Note: this package uses Laravel Analytics, so you need to configure it in your config/analytics.php file.

The config file is documented, so choose the option that best suits your needs.

Usage

use The3LabsTeam\NovaGoogleAnalyticsCards\Counter\ActiveUsersCounter;use The3LabsTeam\NovaGoogleAnalyticsCards\Counter\NewUsersCounter;use The3LabsTeam\NovaGoogleAnalyticsCards\Counter\PageViewsCounter;use The3LabsTeam\NovaGoogleAnalyticsCards\LineChart\PageViewLineChart;

...

(new ActiveUsersCounter())
(new NewUsersCounter())
(new PageViewsCounter())
            
(new PageViewLineChart())

You can also override the name of cards like this:

use The3LabsTeam\NovaGoogleAnalyticsCards\Counter\ActiveUsersCounter;
...

(new ActiveUsersCounter(name: 'The name of the card (string)'))

Using the PageViewLineChart and RefClickPartition card in single Article

1. Add in your Article model the following attribute:

/**
* Return the page path for Google Analytics
*/
public function getGaPagePathAttribute(): string
{
   return str_replace(config('app.url'), '', $this->route);
}

1. Add the card in your Nova\Article resource:

public function cards(NovaRequest $request)
{
    return [
        (new PageViewLineChart(articleId: $request->resourceId))->width('1/2 ')
            ->onlyOnDetail()
            ->height('dynamic'),
        (new RefClickPartition(articleId: $request->resourceId))->width('1/3')
                ->onlyOnDetail()
                ->height('dynamic'),
    ];
}

Sponsor