Initial commit

vendor/maatwebsite/excel/docs/import/basics.md

@@ -0,0 +1,9 @@
+# Importing a file
+
+To start importing a file, you can use `->load($filename)`. The callback is optional.
+
+    Excel::load('file.xls', function($reader) {
+
+        // reader methods
+
+    });

vendor/maatwebsite/excel/docs/import/batch.md

@@ -0,0 +1,43 @@
+#Batch import
+
+### Import a folder
+
+To import an entire folder (only xls, xlsx and csv files will be imported), set the folder as the first parameter.
+
+    Excel::batch('app/storage/uploads', function($rows, $file) {
+
+        // Explain the reader how it should interpret each row,
+        // for every file inside the batch
+        $rows->each(function($row) {
+
+            // Example: dump the firstname
+            dd($row->firstname);
+
+        });
+
+    });
+
+### Import multiple files
+
+It's also possible to provide an array of files to import.
+
+    $files = array(
+        'file1.xls',
+        'file2.xls'
+    );
+
+    Excel::batch($files, function($rows, $file) {
+
+    });
+
+### Import a folder and multiple sheets
+
+When your files contain multiple sheets, you should also loop the sheets
+
+    Excel::batch('app/storage/uploads', function($sheets, $file) {
+
+        $sheets->each(function($sheet) {
+
+        });
+
+    });

vendor/maatwebsite/excel/docs/import/cache.md

@@ -0,0 +1,12 @@
+# Caching and Cell caching
+
+### Cell caching
+
+You can enable cell caching inside the config `cache.php`. You can choose between a couple of drivers and change a couple of settings. By default the caching is **enabled** and will use **in memory** caching.
+
+### Remembering results
+
+If you want to remember the results you can use `->remember($minutes)`. Next time you will load the same file (if it's still inside the cache), it will return the cached results.
+
+    // Remember for 10 minutes
+    $results = $reader->remember(10)->get();

vendor/maatwebsite/excel/docs/import/calculation.md

@@ -0,0 +1,11 @@
+# Calculate formulas
+
+By default formulas inside the file are being calculated and it's result will be returned. Inside `import.php` config you can change the default behaviour by setting `calculate` to the desired preference.
+
+If you want to enable/disable it for a single import, you can use `->calculate($boolean)`
+
+    // Enable calculation
+    $reader->calculate();
+
+    // Disable calculation
+    $reader->calculate(false);

vendor/maatwebsite/excel/docs/import/config.md

@@ -0,0 +1,15 @@
+# Import by Config
+
+When using advanced Excel files (e.g. without any heading columns), it can be complicated to import these.
+`->byConfig()` will help you handle this problem.
+
+Inside `excel::import.sheets` config you can find an example.
+
+    Excel::load('file.xls')->byConfig('excel::import.sheets', function($sheet) {
+
+        // The firstname getter will correspond with a cell coordinate set inside the config
+        $firstname = $sheet->firstname;
+
+    });
+
+> **Note:** if you are using multiple sheets. `->byConfig` will loop through all sheets. If these getters are only exist on one sheet, you can always use `->selectSheets()`.

vendor/maatwebsite/excel/docs/import/dates.md

@@ -0,0 +1,45 @@
+# Dates
+
+By default the dates will be parsed as a **[Carbon object](https://github.com/briannesbitt/Carbon)**. You can disable date formatting completly inside `import.php` by setting `dates.enabled` to `false`.
+
+To enable/disable date formatting for a single import, use `->formatDates($boolean, $format)`
+
+    // Format the dates
+    $reader->formatDates(true);
+
+    // Disable date formatting
+    $reader->formatDates(false);
+
+    // Format dates + set date format
+    $reader->formatDates(true, 'Y-m-d');
+
+### Format dates
+
+By default the dates are **not formatted**, but returned as a Carbon object. There are a couple of options to format them.
+
+#### Formatting results after ->get()
+
+Inside your loop you can utilise the Carbon method `->format($dateFormat)`
+
+    $rows->each(function($row) {
+
+        $created_at = $row->created_at->format('Y-m-d');
+
+    });
+
+#### Setting a default date format
+
+Inside the config you can set a default date format. A Carbon object will no longer be returned.
+
+Or you can use `->setDateFormat()`
+
+    $reader->setDateFormat('Y-m-d');
+
+### Setting custom date columns
+
+Cells which are not Excel formatted dates will not be parsed as a date. To force this behaviour (or to use this with CSV imports), you can set these date columns manually: `->setDateColumns()`
+
+    $reader->setDateColumns(array(
+        'created_at',
+        'deleted_at'
+    ))->get();

vendor/maatwebsite/excel/docs/import/extra.md

@@ -0,0 +1,44 @@
+# Extra
+
+### Disable using first row as collection attributes
+
+By default we will use the first row of a file as table heading (so as attribute names for the collection).
+You can change the default behaviour inside `import.php` with `import.heading`.
+
+To disable this for a single import, use `->noHeading()`.
+
+    $reader->noHeading();
+
+### Setting the cell name separator
+By default collection attribute names will be set by looking at the first row columns. Spaces will be translated to `_`.
+
+**E.g. Created at -> created_at**
+
+The default behaviour can be changed inside the `import.php` config by changing `'separator'`. Or you can use `->setSeparator($separator)`.
+
+    $reader->setSeparator('-');
+
+### Ignoring empty cells
+By default empty cells will not be ignored and presented as null inside the cell collection.
+
+To change the default behaviour, you can change `'ignoreEmpty`' inside `import.php` or use `->ignoreEmpty()`.
+
+    $reader->ignoreEmpty();
+
+### Input encoding
+
+Inside the `import.php` config you can change the input encoding. In most cases **UTF-8** will be the best solution. Hower if you dump your results make sure your HTML page has this exact same meta charset!
+
+Optionally you can pass the input encoding inside the `->load()` method.
+
+    // When utilising a closure, you can pass the input encoding as third parameter.
+    Excel::load('filename.csv', function($reader) {
+
+    }, 'UTF-8');
+
+    // or without a closure, you can use it as second parameter.
+    Excel::load('filename.csv', 'UTF-8');
+
+### CSV Settings
+
+Inside the `csv.php` config you can change the default settings, like the `delimiter`, the `enclosure` and the `line_ending`.

vendor/maatwebsite/excel/docs/import/results.md

@@ -0,0 +1,126 @@
+# Handling imported results
+
+### Getting all sheets and rows
+
+After you have loaded a file, you can `->get()` the results like so:
+
+    Excel::load('file.xls', function($reader) {
+
+    })->get();
+
+or
+
+    Excel::load('file.xls', function($reader) {
+
+        // Getting all results
+        $results = $reader->get();
+
+        // ->all() is a wrapper for ->get() and will work the same
+        $results = $reader->all();
+
+    });
+
+> The `->get()` and `->all()` methods will return a sheet or row collection, depending on the amount of sheets the file has. You can disable this feature inside the `import.php` config by setting `'force_sheets_collection'` to `true`. When set to true it will always return a sheet collection.
+
+### Table heading as attributes
+
+By default the first row of the excel file will be used as attributes.
+
+    // Get the firstname
+    $row->firstname;
+
+> **Note**: by default these attributes will be converted to a slug. You can change the default inside the config `excel::import.heading`. Available options are: `true|false|slugged|ascii|numeric|hashed|trans|original`
+
+> True and slugged will be converted to ASCII as well when `excel::import.to_ascii` is set to true. You can change the default separator as well inside the config.
+
+### Collections
+
+Sheets, rows and cells are collections, this means after doing a `->get()` you can use all default collection methods.
+
+    // E.g. group the results
+    $reader->get()->groupBy('firstname');
+
+### Getting the first sheet or row
+
+To get the first sheet or row, you can utilise `->first()`.
+
+    $reader->first();
+
+> **Note:** depending on the config `'force_sheets_collection'` it will return the first row or sheet.
+
+### Workbook and sheet title
+
+It's possible to retrieve the workbook and sheet title with `->getTitle()`.
+
+    // Get workbook title
+    $workbookTitle = $reader->getTitle();
+
+    foreach($reader as $sheet)
+    {
+        // get sheet title
+        $sheetTitle = $sheet->getTitle();
+    }
+
+### Limiting the results
+
+##### Taking rows
+
+When you only want to return the first x rows of a sheet, you can use `->take()` or `->limit()`.
+
+    // You can either use ->take()
+    $reader->take(10);
+
+    // Or ->limit()
+    $reader->limit(10);
+
+##### Skipping rows
+
+When you want to skip a certain amount of rows you can use `->skip()` or `->limit(false, 10)`
+
+    // Skip 10 results
+    $reader->skip(10);
+
+    // Skip 10 results with limit, but return all other rows
+    $reader->limit(false, 10);
+
+    // Skip and take
+    $reader->skip(10)->take(10);
+
+    // Limit with skip and take
+    $reader->($skip, $take);
+
+### Result mutators
+
+When you want to get an array instead of an object, you can use `->toArray()`.
+
+    $reader->toArray();
+
+When you want an object, you can alternativly (instead of get() or all()) use `->toObject()`.
+
+    $reader->toObject();
+
+### Displaying results
+
+You can dump the results to a readable output by using `->dump()` or `->dd()`.
+
+    // Dump the results
+    $reader->dump();
+
+    // Dump results and die
+    $reader->dd();
+
+### Iterating the results
+
+You can iterate the results by using `->each()`.
+
+    // Loop through all sheets
+    $reader->each(function($sheet) {
+
+        // Loop through all rows
+        $sheet->each(function($row) {
+
+        });
+
+    });
+
+> Alternatively you can also `foreach` the results.

vendor/maatwebsite/excel/docs/import/select.md

@@ -0,0 +1,31 @@
+# Selecting sheets and columns
+
+### Selecting one specific sheet
+If you want to select a single sheet, you can use `->selectSheets($name)`. Only that sheet will be loaded.
+
+    Excel::selectSheets('sheet1')->load();
+
+### Selecting multiple sheets
+If you want to select multiple sheets inside your file, you can pass an array as the parameter;
+
+    Excel::selectSheets('sheet1', 'sheet2')->load();
+
+### Selecting sheets by index
+
+    // First sheet
+    Excel::selectSheetsByIndex(0)->load();
+
+    // First and second sheet
+    Excel::selectSheetsByIndex(0, 1)->load();
+
+### Selecting columns
+
+If you want to select only a couple of columns, you can use `->select($columns)` or pass an array as the first parameter of `->get($columns)`.
+
+    // Select
+    $reader->select(array('firstname', 'lastname'))->get();
+
+    // Or
+    $reader->get(array('firstname', 'lastname'));
+
+> All get methods (like all(), first(), dump(), toArray(), ...) accept an array of columns.