Welcome laravel-dashboard-devto-tile 🎉

.editorconfig

@@ -0,0 +1,18 @@
+; This file is for unifying the coding style for different editors and IDEs.
+; More information at https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+indent_size = 4
+indent_style = space
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.yml]
+indent_size = 2

.gitattributes

@@ -0,0 +1,13 @@
+# Path-based git attributes
+# https://www.kernel.org/pub/software/scm/git/docs/gitattributes.html
+
+# Ignore all test and documentation with "export-ignore".
+/.gitattributes     export-ignore
+/.gitignore         export-ignore
+/.travis.yml        export-ignore
+/phpunit.xml.dist   export-ignore
+/tests              export-ignore
+/.editorconfig      export-ignore
+/.php.cs            export-ignore
+/.github            export-ignore
+

.gitignore

@@ -0,0 +1,9 @@
+build
+composer.lock
+docs
+vendor
+coverage
+.phpunit.result.cache
+.idea
+.php_cs.cache
+

.php_cs

@@ -0,0 +1,38 @@
+<?php
+
+$finder = Symfony\Component\Finder\Finder::create()
+    ->notPath('bootstrap/*')
+    ->notPath('storage/*')
+    ->notPath('storage/*')
+    ->notPath('resources/view/mail/*')
+    ->in([
+        __DIR__ . '/src',
+        __DIR__ . '/tests',
+    ])
+    ->name('*.php')
+    ->notName('*.blade.php')
+    ->ignoreDotFiles(true)
+    ->ignoreVCS(true);
+
+return PhpCsFixer\Config::create()
+    ->setRules([
+        '@PSR2' => true,
+        'array_syntax' => ['syntax' => 'short'],
+        'ordered_imports' => ['sortAlgorithm' => 'alpha'],
+        'no_unused_imports' => true,
+        'not_operator_with_successor_space' => true,
+        'trailing_comma_in_multiline_array' => true,
+        'phpdoc_scalar' => true,
+        'unary_operator_spaces' => true,
+        'binary_operator_spaces' => true,
+        'blank_line_before_statement' => [
+            'statements' => ['break', 'continue', 'declare', 'return', 'throw', 'try'],
+        ],
+        'phpdoc_single_line_var_spacing' => true,
+        'phpdoc_var_without_name' => true,
+        'method_argument_space' => [
+            'on_multiline' => 'ensure_fully_multiline',
+            'keep_multiple_spaces_after_comma' => true,
+        ]
+    ])
+    ->setFinder($finder);

CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing
+
+Contributions are **welcome** and will be fully **credited**.
+
+Please read and understand the contribution guide before creating an issue or pull request.
+
+## Etiquette
+
+This project is open source, and as such, the maintainers give their free time to build and maintain the source code
+held within. They make the code freely available in the hope that it will be of use to other developers. It would be
+extremely unfair for them to suffer abuse or anger for their hard work.
+
+Please be considerate towards maintainers when raising issues or presenting pull requests. Let's show the
+world that developers are civilized and selfless people.
+
+It's the duty of the maintainer to ensure that all submissions to the project are of sufficient
+quality to benefit the project. Many developers have different skillsets, strengths, and weaknesses. Respect the maintainer's decision, and do not be upset or abusive if your submission is not used.
+
+## Viability
+
+When requesting or submitting new features, first consider whether it might be useful to others. Open
+source projects are used by many developers, who may have entirely different needs to your own. Think about
+whether or not your feature is likely to be used by other users of the project.
+
+## Procedure
+
+Before filing an issue:
+
+- Attempt to replicate the problem, to ensure that it wasn't a coincidental incident.
+- Check to make sure your feature suggestion isn't already present within the project.
+- Check the pull requests tab to ensure that the bug doesn't have a fix in progress.
+- Check the pull requests tab to ensure that the feature isn't already in progress.
+
+Before submitting a pull request:
+
+- Check the codebase to ensure that your feature doesn't already exist.
+- Check the pull requests to ensure that another person hasn't already submitted the feature or fix.
+
+## Requirements
+
+If the project maintainer has any additional requirements, you will find them listed here.
+
+- **[PSR-2 Coding Standard](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** - The easiest way to apply the conventions is to install [PHP Code Sniffer](https://pear.php.net/package/PHP_CodeSniffer).
+
+- **Add tests!** - Your patch won't be accepted if it doesn't have tests.
+
+- **Document any change in behaviour** - Make sure the `README.md` and any other relevant documentation are kept up-to-date.
+
+- **Consider our release cycle** - We try to follow [SemVer v2.0.0](https://semver.org/). Randomly breaking public APIs is not an option.
+
+- **One pull request per feature** - If you want to do more than one thing, send multiple pull requests.
+
+- **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please [squash them](https://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages) before submitting.
+
+**Happy coding**!

LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Roberto Butti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

composer.json

@@ -0,0 +1,50 @@
+{
+    "name": "hi-folks/laravel-dashboard-devto-tile",
+    "description": "Tile for Spatie Laravel Dashboard to list DEV.to articles",
+    "keywords": [
+        "hi-folks",
+        "laravel-dashboard-devto-tile"
+    ],
+    "homepage": "https://github.com/hi-folks/laravel-dashboard-devto-tile",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Roberto Butti",
+            "role": "Developer"
+        }
+    ],
+    "require": {
+        "php": "^7.4",
+        "spatie/laravel-dashboard": "^1.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^9.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "HiFolks\\DevtoTile\\": "src"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "HiFolks\\DevtoTile\\Tests\\": "tests"
+        }
+    },
+    "scripts": {
+        "test": "vendor/bin/phpunit",
+        "test-coverage": "vendor/bin/phpunit --coverage-html coverage",
+        "format": "vendor/bin/php-cs-fixer fix --allow-risky=yes"
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "HiFolks\\DevtoTile\\DevtoTileServiceProvider"
+            ]
+        }
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}

phpunit.xml.dist

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit bootstrap="vendor/autoload.php"
+         backupGlobals="false"
+         backupStaticAttributes="false"
+         colors="true"
+         verbose="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false">
+    <testsuites>
+        <testsuite name="Test Suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+    <filter>
+        <whitelist>
+            <directory suffix=".php">src/</directory>
+        </whitelist>
+    </filter>
+    <logging>
+        <log type="junit" target="build/report.junit.xml"/>
+        <log type="coverage-html" target="build/coverage"/>
+        <log type="coverage-text" target="build/coverage.txt"/>
+        <log type="coverage-clover" target="build/logs/clover.xml"/>
+    </logging>
+</phpunit>

resources/views/tile.blade.php

@@ -0,0 +1,26 @@
+<x-dashboard-tile :position="$position">
+
+        <div class="font-bold text-3xl leading-none mb-2"><a href="https://dev.to/dashboard">DEV.TO Articles</a></div>
+
+        <div wire:poll.{{ $refreshIntervalInSeconds }}s class="self-center | divide-y-2">
+            <table class="table-auto">
+                <thead>
+                    <tr>
+                        <th class="px-4 py-2">Title</th>
+                        <th class="px-4 py-2">Views</th>
+                        <th class="px-4 py-2">Reactions</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    @foreach ($articles as $item)
+                    <tr>
+                        <td class="border px-4 py-2">{{ $item["title"] }}</td>
+                        <td class="border px-4 py-2">{{ $item["page_views_count"] }}</td>
+                        <td class="border px-4 py-2">{{ $item["public_reactions_count"] }}</td>
+                    </tr>
+                    @endforeach
+                </tbody>
+            </table>
+        </div>
+
+</x-dashboard-tile>

src/DevtoStore.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace HiFolks\DevtoTile;
+
+use Spatie\Dashboard\Models\Tile;
+
+class DevtoStore
+{
+    private Tile $tile;
+
+    public const TILE_NAME= "DevtoTile";
+    public const TILE_KEY_ARTICLES = "keyDevtoArticles";
+
+    public static function make()
+    {
+        return new static();
+    }
+
+    public function __construct()
+    {
+        $this->tile = Tile::firstOrCreateForName(self::TILE_NAME);
+    }
+
+    public function setData(array $data): self
+    {
+        $this->tile->putData(self::TILE_KEY_ARTICLES, $data);
+
+        return $this;
+    }
+
+    public function getData(): array
+    {
+        return$this->tile->getData(self::TILE_KEY_ARTICLES) ?? [];
+    }
+}

src/DevtoTileComponent.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace HiFolks\DevtoTile;
+
+use Livewire\Component;
+
+class DevtoTileComponent extends Component
+{
+    /** @var string */
+    public $position;
+
+    public function mount(string $position)
+    {
+        $this->position = $position;
+    }
+
+    public function render()
+    {
+        return view('dashboard-devto-tile::tile', [
+            'articles' => DevtoStore::make()->getData(),
+            'refreshIntervalInSeconds' => config('dashboard.tiles.devto.refresh_interval_in_seconds', 60),
+
+        ]);
+    }
+}

src/DevtoTileServiceProvider.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace HiFolks\DevtoTile;
+
+use Illuminate\Support\ServiceProvider;
+use Livewire\Livewire;
+
+class DevtoTileServiceProvider extends ServiceProvider
+{
+    public function boot()
+    {
+        if ($this->app->runningInConsole()) {
+            $this->commands([
+                FetchDataFromApiCommand::class,
+            ]);
+        }
+
+        $this->publishes([
+            __DIR__ . '/../resources/views' => resource_path('views/vendor/dashboard-devto-tile'),
+        ], 'dashboard-devto-tile-views');
+
+        $this->loadViewsFrom(__DIR__ . '/../resources/views', 'dashboard-devto-tile');
+
+        Livewire::component('devto-tile', DevtoTileComponent::class);
+    }
+}

src/FetchDataFromApiCommand.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace HiFolks\DevtoTile;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Facades\Http;
+
+class FetchDataFromApiCommand extends Command
+{
+    protected $signature = 'dashboard:fetch-data-from-devto-api';
+
+    protected $description = 'Fetch data from DEV.to API for tile';
+
+    public function handle()
+    {
+        $this->info('Fetching DEVto articles...');
+
+        $endpoint = "https://dev.to/api/articles/me/published";
+
+
+        $token = config('dashboard.tiles.devto.configurations.default.api_key');
+        $response = Http::withHeaders([
+            'api-key' => $token,
+
+        ])->get($endpoint);
+
+        $myData = $response->json();
+        $sorted=[];
+        if ($response->status() === 200) {
+            $sorted = array_reverse(Arr::sort($myData, function ($value) {
+                return $value['page_views_count'];
+            }));
+            DevtoStore::make()->setData($sorted);
+        }
+
+        $this->info('All done, HTTP status:'. $response->status());
+    }
+}