adeweb/laravel-nova-matomo-cards

dev-master 2022-02-05 14:41 UTC

Requires

• php: ^7.4|^8
• thijssimonis/nova-list-card: ^1.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.16
• orchestra/testbench: ^5.0
• phpunit/phpunit: ^9.3
• psalm/plugin-laravel: ^1.2
• vimeo/psalm: ^3.11

MIT

• Antoine Duchêne

• nova
• cards
• matomo
• laravel nova
• laravel-nova-matomo-cards

README

Installation

You can install the package via composer:

composer require adeweb/laravel-nova-matomo-cards

You can publish the config file with:

php artisan vendor:publish --provider="Adeweb\NovaMatomoCards\NovaMatomoCardsServiceProvider" --tag="config"

This is the contents of the published config file:

return [
    'token' => env('MATOMO_API_TOKEN'),
    'url' => env('MATOMO_API_URL'),
    'site_id' => env('MATOMO_API_SITE_ID')
];

Note: It is better to use ENV variables than publishing and editing the config file.

Usage

In NovaServiceProvider.php :

use Adeweb\NovaMatomoCards\Cards\LastMonthDeviceTypePartition;
use Adeweb\NovaMatomoCards\Cards\LastMonthCitiesByVisitorCountList;
use Adeweb\NovaMatomoCards\Cards\LastMonthPageByVisitorList;
use Adeweb\NovaMatomoCards\Cards\LiveVisitorsCount;
use Adeweb\NovaMatomoCards\Cards\PageViewsCount;
use Adeweb\NovaMatomoCards\Cards\PageViewsPerDayTrend;
use Adeweb\NovaMatomoCards\Cards\LastMonthReferrersPartition;
use Adeweb\NovaMatomoCards\Cards\UniqueVisitorsCount;
use Adeweb\NovaMatomoCards\Cards\UniqueVisitorsPerDayTrend;

    /**
     * Get the cards that should be displayed on the default Nova dashboard.
     *
     * @return array
     */
    protected function cards()
    {
        return [
            (new UniqueVisitorsPerDayTrend())->width('1/2')->defaultRange('30'),
            (new UniqueVisitorsCount())->width('1/4')->defaultRange('month'),
            (new LiveVisitorsCount())->width('1/4')->defaultRange('720'),
            (new PageViewsPerDayTrend())->width('1/2')->defaultRange('30'),
            (new PageViewsCount())->width('1/4')->defaultRange('month'),
            (new LastMonthReferrersPartition())->width('1/2'),
            (new LastMonthDeviceTypePartition())->width('1/2'),
            (new LastMonthCitiesByVisitorCountList())->width('1/2'),
            (new LastMonthPageByVisitorList())->width('1/2'),
        ];
    }
    

In your .env file :

MATOMO_API_TOKEN="[Your Matomo API token]"
MATOMO_API_URL="[Your Matomo instance URL]"
MATOMO_API_SITE_ID="[Your Matomo Site ID]"

Testing

NTBD

Credits

• Antoine Duchêne

License

The MIT License (MIT). Please see License File for more information.