Improve error handling in API requests

add-column.md

@@ -1,36 +1,38 @@
 # Add Column
 
-You can add a custom column on your response by using `addColumn` api.
+You can add a custom column to your response by using the `addColumn` api.
+
+> {note} added columns are assumed to be computed columns and not part of the database. Thus, search/sort will be disabled for those columns. If you need them, use the `editColumn` api instead.
 
 <a name="blade"></a>
 ## Add Column with Blade Syntax
 
 ```php
-use Datatables;
+use DataTables;
 
 Route::get('user-data', function() {
 	$model = App\User::query();
 
-	return Datatables::eloquent($model)
+	return DataTables::eloquent($model)
 				->addColumn('intro', 'Hi {{$name}}!')
-				->make(true);
+				->toJson();
 });
 ```
 
 <a name="closure"></a>
 ## Add Column with Closure
 
 ```php
-use Datatables;
+use DataTables;
 
 Route::get('user-data', function() {
 	$model = App\User::query();
 
-	return Datatables::eloquent($model)
+	return DataTables::eloquent($model)
 				->addColumn('intro', function(User $user) {
 					return 'Hi ' . $user->name . '!';
 				})
-				->make(true);
+				->toJson();
 });
 ```
 
@@ -40,14 +42,14 @@ Route::get('user-data', function() {
 > {tip} You can use view to render your added column by passing the view path as the second argument on `addColumn` api.
 
 ```php
-use Datatables;
+use DataTables;
 
 Route::get('user-data', function() {
 	$model = App\User::query();
 
-	return Datatables::eloquent($model)
+	return DataTables::eloquent($model)
 				->addColumn('intro', 'users.datatables.intro')
-				->make(true);
+				->toJson();
 });
 ```
 
@@ -62,13 +64,13 @@ Hi {{ $name }}!
 > {tip} Just pass the column order as the third argument of `addColumn` api.
 
 ```php
-use Datatables;
+use DataTables;
 
 Route::get('user-data', function() {
 	$model = App\User::query();
 
-	return Datatables::eloquent($model)
+	return DataTables::eloquent($model)
 				->addColumn('intro', 'Hi {{$name}}!', 2)
-				->make(true);
+				->toJson();
 });
 ```

add-columns.md

@@ -0,0 +1,52 @@
+# Add Columns
+
+Add mutated / hidden columns.
+
+<a name="blade"></a>
+## Add hidden model columns
+
+```php
+use DataTables;
+
+Route::get('user-data', function() {
+	$model = App\User::query();
+
+	return DataTables::eloquent($model)
+				->addColumns(['foo','bar','buzz'=>"red"])
+				->toJson();
+});
+```
+
+<a name="response"></a>
+## Example Response
+
+```json
+{
+	"draw": 2,
+	"recordsTotal": 10,
+	"recordsFiltered": 3,
+	"data": [{
+		"id": 476,
+		"name": "Esmeralda Kulas",
+		"email": "[email protected]",
+		"created_at": "2016-07-31 23:26:14",
+		"updated_at": "2016-07-31 23:26:14",
+		"deleted_at": null,
+		"superior_id": 0,
+		"foo":"value",
+		"bar":"value",
+		"buzz":"red"
+	}, {
+		"id": 6,
+		"name": "Zachery Muller",
+		"email": "[email protected]",
+		"created_at": "2016-07-31 23:25:43",
+		"updated_at": "2016-07-31 23:25:43",
+		"deleted_at": null,
+		"superior_id": 1,
+		"foo":"value",
+        "bar":"value",
+        "buzz":"red"
+	}]
+}
+```

blacklist.md

@@ -3,13 +3,13 @@
 Sorting and searching will not work on columns explicitly defined as blacklisted.
 
 ```php
-use Datatables;
+use DataTables;
 
 Route::get('user-data', function() {
 	$model = App\User::query();
 
-	return Datatables::eloquent($model)
+	return DataTables::eloquent($model)
 				->blacklist(['password', 'name'])
-				->make(true);
+				->toJson();
 });
-```
+```

buttons-config.md

@@ -1,57 +1,62 @@
 # Buttons Configurations
 
+<a name="console"></a>
+## Artisan Console Configurations
+Namespace configuration is used by the datatables command generator.
+
 ```php
-return [
-    /**
-     * DataTables script view template.
-     */
-    'script_template' => 'datatables::script',
-
-    /**
-     * Namespaces used by the generator.
-     */
-    'namespace'       => [
-        /**
-         * Base namespace/directory to create the new file.
-         * This is appended on default Laravel namespace.
-         * Usage: php artisan datatables:make User
-         * Output: App\DataTables\UserDataTable
-         * With Model: App\User (default model)
-         * Export filename: users_timestamp
-         */
-        'base'  => 'DataTables',
-
-        /**
-         * Base namespace/directory where your model's are located.
-         * This is appended on default Laravel namespace.
-         * Usage: php artisan datatables:make Post --model
-         * Output: App\DataTables\PostDataTable
-         * With Model: App\Post
-         * Export filename: posts_timestamp
-         */
-        'model' => '',
-    ],
+'namespace' => [
+    'base'  => 'DataTables',
+    'model' => '',
+],
+```
+
+### DataTable Base Namespace/Directory
+This is the base namespace/directory to be created when a new DataTable is called.
+This directory is appended to the default Laravel namespace.
+
+**Usage:**
+```php artisan datatables:make User```
+
+**Output:**
+```App\DataTables\UserDataTable```
+
+**Export filename:** ```users_(timestamp)```
+
+### Model Option
+This is the base namespace/directory where your models are located.
+This directory is appended to the default Laravel namespace.
+**Usage:** ```php artisan datatables:make Post --model```
+**Output:** ```App\DataTables\PostDataTable```
+**With Model:** ```App\Post``
+**Export filename:** ```posts_(timestamp)```
 
-    /**
-     * PDF generator to be used when converting the table to pdf.
-     * Available generators: excel, snappy
-     * Snappy package: barryvdh/laravel-snappy
-     * Excel package: maatwebsite/excel
-     */
-    'pdf_generator'   => 'excel',
-
-    /**
-     * Snappy PDF options.
-     */
-    'snappy'          => [
-        'options'     => [
-            'no-outline'    => true,
-            'margin-left'   => '0',
-            'margin-right'  => '0',
-            'margin-top'    => '10mm',
-            'margin-bottom' => '10mm',
-        ],
-        'orientation' => 'landscape',
+<a name="pdf-generator"></a>
+## PDF Generator
+Set the PDF generator to be used when converting your dataTable to PDF.
+
+Available generators are: `excel`, `snappy`
+
+### Excel Generator
+When `excel` is used as the generator, the package will use [`maatwebsite/excel`](http://www.maatwebsite.nl/laravel-excel/docs) to generate the PDF.
+
+> To export files to pdf, you will have to include "dompdf/dompdf": "~0.6.1", "mpdf/mpdf": "~5.7.3" or "tecnick.com/tcpdf": "~6.0.0" in your composer.json and change the export.pdf.driver config setting accordingly.
+
+### Snappy Generator (Default Generator)
+When `snappy` is used as the generator, you need to install [`barryvdh/laravel-snappy`](https://github.com/barryvdh/laravel-snappy)
+
+### Snappy PDF Options
+These are the options passed to `laravel-snappy` when exporting the pdf file.
+
+```php
+'snappy'          => [
+    'options'     => [
+        'no-outline'    => true,
+        'margin-left'   => '0',
+        'margin-right'  => '0',
+        'margin-top'    => '10mm',
+        'margin-bottom' => '10mm',
     ],
-];
+    'orientation' => 'landscape',
+],
 ```