First 🚀

yajra · yajra · commit f8a7efd2ff9f · 2021-09-23T18:11:46.000+08:00
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,16 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.yml]
+indent_style = space
+indent_size = 2
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,11 @@
+* text=auto
+
+/tests export-ignore
+.github/ export-ignore
+.editorconfig export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+.php_cs export-ignore
+.scrutinizer.yml export-ignore
+.travis.yml export-ignore
+phpunit.xml export-ignore
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
@@ -0,0 +1,19 @@
+# Contributing
+
+Contributions are **welcome** and will be fully **credited**.
+
+We accept contributions via Pull Requests on [Github](https://github.com/yajra/laravel-datatables-export).
+
+
+## Pull Requests
+
+- **[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](http://pear.php.net/package/PHP_CodeSniffer).
+
+- **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](http://semver.org/). Randomly breaking public APIs is not an option.
+
+- **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 before submitting.
+
+
+**Happy coding**!
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -0,0 +1,2 @@
+patreon: yajra
+custom: https://www.paypal.me/yajra
diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,31 @@
+
+### Summary of problem or feature request
+
+<!-- Please describe your problem/feature request here. -->
+
+
+### Code snippet of problem
+
+<!--
+If applicable, please include a copy of your code
+which triggers the suspected bug.
+
+You may use the markdown php code tags to format your paste:
+
+```php
+$params = ['foo'];
+```
+-->
+
+### System details
+
+<!--
+Please include these details about your system!
+If they are omitted, the ticket will be deprioritized
+over other users requests/tickets.
+-->
+
+- Operating System
+- PHP Version
+- Laravel Version
+- Laravel-DataTables Version
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,10 @@
+<!--
+
+Thanks for the Pull Request!  Before you submit the PR, please
+look over this checklist:
+
+- Have you read the [Contributing Guidelines](https://github.com/yajra/laravel-datatables-export/blob/master/.github/CONTRIBUTING.md)?
+
+If you answered yes, thanks for the PR and we'll get to it ASAP! :)
+
+-->
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,4 @@
+/vendor
+/coverage
+composer.phar
+composer.lock
diff --git a/.styleci.yml b/.styleci.yml
@@ -0,0 +1 @@
+preset: laravel
diff --git a/.travis.yml b/.travis.yml
@@ -0,0 +1,18 @@
+language: php
+
+php:
+  - 7.1
+  - 7.2
+
+env:
+  global:
+    - setup=basic
+
+sudo: false
+
+install:
+  - if [[ $setup = 'basic' ]]; then travis_retry composer install --no-interaction --prefer-source; fi
+  - if [[ $setup = 'stable' ]]; then travis_retry composer update --prefer-source --no-interaction --prefer-stable; fi
+  - if [[ $setup = 'lowest' ]]; then travis_retry composer update --prefer-source --no-interaction --prefer-lowest --prefer-stable; fi
+
+script: vendor/bin/phpunit
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,4 @@
+# Laravel DataTables Export Plugin CHANGELOG.
+
+## UNRELEASED
+
diff --git a/LICENSE.md b/LICENSE.md
@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2013-2021 Arjay Angeles <aqangeles@gmail.com>
+
+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.
diff --git a/README.md b/README.md
@@ -0,0 +1,52 @@
+# Laravel DataTables Export Plugin
+
+[![Laravel 8.x](https://img.shields.io/badge/Laravel-8.x-orange.svg)](http://laravel.com)
+[![Latest Stable Version](https://img.shields.io/packagist/v/yajra/laravel-datatables-export.svg)](https://packagist.org/packages/yajra/laravel-datatables-export)
+[![Build Status](https://travis-ci.org/yajra/laravel-datatables-export.svg?branch=master)](https://travis-ci.org/yajra/laravel-datatables-export)
+[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/yajra/laravel-datatables-export/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/yajra/laravel-datatables-export/?branch=master)
+[![Total Downloads](https://img.shields.io/packagist/dt/yajra/laravel-datatables-export.svg)](https://packagist.org/packages/yajra/laravel-datatables-export)
+[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://packagist.org/packages/yajra/laravel-datatables-export)
+
+This package is a plugin of [Laravel DataTables](https://github.com/yajra/laravel-datatables) for handling server-side exporting using Queue and Livewire.
+
+## Requirements
+- [PHP >=7.4](http://php.net/)
+- [Laravel 8.x](https://github.com/laravel/framework)
+- [Laravel DataTables 9.x](https://github.com/yajra/laravel-datatables)
+- [jQuery DataTables v1.10.x](http://datatables.net/)
+- [jQuery DataTables Buttons Extension](https://datatables.net/reference/button/)
+
+## Documentations
+- [Laravel DataTables Documentation](http://yajrabox.com/docs/laravel-datatables)
+
+## NOTE
+This version is still on experimental stage. Until Laravel DataTables v8.x stable version is released,
+there might be a breaking changes that may be included on future releases.
+
+## Quick Installation
+`composer require yajra/laravel-datatables-export`
+
+#### Service Provider (Optional on Laravel 5.5)
+`Yajra\DataTables\ExportServiceProvider::class`
+
+#### Configuration and Assets (Optional)
+`$ php artisan vendor:publish --tag=datatables-export --force`
+
+And that's it! Start building out some awesome DataTables!
+
+## Contributing
+
+Please see [CONTRIBUTING](https://github.com/yajra/laravel-datatables-export/blob/master/.github/CONTRIBUTING.md) for details.
+
+## Security
+
+If you discover any security related issues, please email [aqangeles@gmail.com](mailto:aqangeles@gmail.com) instead of using the issue tracker.
+
+## Credits
+
+- [Arjay Angeles](https://github.com/yajra)
+- [All Contributors](https://github.com/yajra/laravel-datatables-export/graphs/contributors)
+
+## License
+
+The MIT License (MIT). Please see [License File](https://github.com/yajra/laravel-datatables-export/blob/master/LICENSE.md) for more information.
diff --git a/composer.json b/composer.json
@@ -0,0 +1,49 @@
+{
+  "name": "yajra/laravel-datatables-export",
+  "description": "Laravel DataTables Queued Export Plugin.",
+  "keywords": [
+    "laravel",
+    "datatables",
+    "export",
+    "jquery"
+  ],
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "Arjay Angeles",
+      "email": "aqangeles@gmail.com"
+    }
+  ],
+  "require": {
+    "php": ">=7.4|8.*",
+    "yajra/laravel-datatables-buttons": "4.*",
+    "maatwebsite/excel": "^3.0",
+    "livewire/livewire": "^2.6",
+    "laravel/framework": "^8.61"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^9.5.9"
+  },
+  "autoload": {
+    "psr-4": {
+      "Yajra\\DataTables\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Yajra\\DataTables\\Tests\\": "tests/"
+    }
+  },
+  "extra": {
+    "branch-alias": {
+      "dev-master": "1.0-dev"
+    },
+    "laravel": {
+      "providers": [
+        "Yajra\\DataTables\\ExportServiceProvider"
+      ]
+    }
+  },
+  "minimum-stability": "dev",
+  "prefer-stable": true
+}
diff --git a/phpunit.xml b/phpunit.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+>
+    <testsuites>
+        <testsuite name="Package Test Suite">
+            <directory suffix=".php">./tests/</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>
diff --git a/src/ExportServiceProvider.php b/src/ExportServiceProvider.php
@@ -0,0 +1,52 @@
+<?php
+
+namespace Yajra\DataTables;
+
+use Illuminate\Support\ServiceProvider;
+use Livewire\Livewire;
+use Maatwebsite\Excel\ExcelServiceProvider;
+use Yajra\DataTables\Generators\DataTablesHtmlCommand;
+use Yajra\DataTables\Generators\DataTablesMakeCommand;
+use Yajra\DataTables\Generators\DataTablesScopeCommand;
+use Yajra\DataTables\Livewire\ExportButtonComponent;
+
+class ExportServiceProvider extends ServiceProvider
+{
+    /**
+     * Bootstrap the application events.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+        $this->loadViewsFrom(__DIR__ . '/resources/views', 'datatables-export');
+
+        $this->publishAssets();
+
+        Livewire::component('export-button', ExportButtonComponent::class);
+    }
+
+    /**
+     * Publish datatables assets.
+     */
+    protected function publishAssets()
+    {
+        $this->publishes([
+            __DIR__ . '/config/datatables-export.php' => config_path('datatables-export.php'),
+        ], 'datatables-export');
+
+        $this->publishes([
+            __DIR__ . '/resources/views' => base_path('/resources/views/vendor/datatables-export'),
+        ], 'datatables-export');
+    }
+
+    /**
+     * Register the service provider.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        $this->mergeConfigFrom(__DIR__ . '/config/datatables-export.php', 'datatables-export');
+    }
+}
diff --git a/src/Exports/DataTableQueuedExport.php b/src/Exports/DataTableQueuedExport.php
@@ -0,0 +1,43 @@
+<?php
+
+namespace Yajra\DataTables\Exports;
+
+use Illuminate\Support\Collection;
+use Maatwebsite\Excel\Concerns\Exportable;
+use Maatwebsite\Excel\Concerns\FromQuery;
+use Maatwebsite\Excel\Concerns\WithHeadings;
+use Maatwebsite\Excel\Concerns\WithMapping;
+use Yajra\DataTables\Html\Column;
+
+class DataTableQueuedExport implements FromQuery, WithMapping, WithHeadings
+{
+    use Exportable;
+
+    protected $query;
+    protected $columns;
+
+    public function __construct($query, Collection $columns)
+    {
+        $this->query = $query;
+        $this->columns = $columns;
+    }
+
+    public function query()
+    {
+        return $this->query;
+    }
+
+    public function map($row): array
+    {
+        return $this->columns
+            ->map(function (Column $column) use ($row) {
+                return $row[$column['name']];
+            })
+            ->toArray();
+    }
+
+    public function headings(): array
+    {
+        return $this->columns->pluck('title')->toArray();
+    }
+}
diff --git a/src/Jobs/DataTableExportJob.php b/src/Jobs/DataTableExportJob.php
diff --git a/src/Livewire/ExportButtonComponent.php b/src/Livewire/ExportButtonComponent.php
diff --git a/src/WithExportQueue.php b/src/WithExportQueue.php
diff --git a/src/config/datatables-export.php b/src/config/datatables-export.php
diff --git a/src/resources/views/export-button.blade.php b/src/resources/views/export-button.blade.php
diff --git a/tests/.gitkeep b/tests/.gitkeep

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+patreon: yajra`
	`2`	`+custom: https://www.paypal.me/yajra`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +# Laravel DataTables Export Plugin CHANGELOG.
++
 +## UNRELEASED
++