Init blud

Author: m2de

.vuepress/components/ItemList.vue

@@ -0,0 +1,25 @@
+<template>
+    <div>
+        <router-link
+            v-for="item in items"
+            :key="item.key"
+            :to="item.path"
+        >
+            <h2>{{ item.title }}</h2>
+        </router-link>
+    </div>
+</template>
+
+<script>
+export default {
+    computed: {
+        items() {
+            const folder = this.$page.path
+
+            return this.$site.pages
+                .filter(page => page.path.match(new RegExp(`(${folder})(?=.*html)`)))
+                .sort((a, b) => new Date(b.frontmatter.date) - new Date(a.frontmatter.date))
+        }
+    }
+}
+</script>

.vuepress/components/RandomItems.vue

@@ -0,0 +1,54 @@
+<template>
+    <div>
+        <router-link
+            v-for="item in items"
+            :key="item.key"
+            :to="item.path"
+        >
+            <h2>{{ item.title}}</h2>
+        </router-link>
+    </div>
+</template>
+
+<script>
+export default {
+    props: [
+        'count',
+    ],
+
+    computed: {
+
+        numberOfItems() {
+            const numberOfItems = this.count || 5
+            const numberOfPages = this.$site.pages.filter(page => page.path.match(new RegExp(`(?=.*html)`))).length
+
+            return numberOfPages < numberOfItems ? numberOfPages : numberOfItems
+        },
+
+        items() {
+            return this.getRandom(this.$site.pages
+                .filter(page => page.path.match(new RegExp(`(?=.*html)`))), this.numberOfItems)
+        }
+
+},
+
+    methods: {
+        /**
+         * Credit: https://stackoverflow.com/a/19270021
+         */
+        getRandom(arr, n) {
+            let result = new Array(n),
+                len = arr.length,
+                taken = new Array(len);
+            if (n > len)
+                throw new RangeError("getRandom: more elements taken than available");
+            while (n--) {
+                var x = Math.floor(Math.random() * len);
+                result[n] = arr[x in taken ? taken[x] : x];
+                taken[x] = --len in taken ? taken[len] : len;
+            }
+            return result;
+        }
+    },
+}
+</script>

.vuepress/components/RenderMarkdown.vue

@@ -0,0 +1,5 @@
+<template>
+  <div>
+    <slot></slot>
+  </div>
+</template>

.vuepress/config.js

@@ -0,0 +1,23 @@
+module.exports = {
+    title: 'Planet Laravel Code Hub',
+    description: 'Useful, interesting and fun code snippets for the Laravel PHP Framework',
+    themeConfig: {
+        nav: [
+            { text: 'Planet Laravel', link: 'https://www.planetlaravel.com' },
+        ],
+        sidebar: [
+            '/random/',
+            '/generic/',
+            '/authentication/',
+            '/database/',
+            '/interfaces/',
+            '/models/',
+            '/tinker/',
+            '/testing/',
+        ],
+        lastUpdated: 'Last Updated',
+        serviceWorker: {
+            updatePopup: true
+          }
+    }
+}

README.md

@@ -0,0 +1,13 @@
+---
+home: true
+actionText: Get Started →
+actionLink: /random/
+features:
+- title: Open-source
+  details: Got some code to share? Just open a Pull Request on this repository. Anyone is welcome to contribute.
+- title: Searchable
+  details: Start by entering a command or area of interest to see what hidden-gems you can uncover.
+- title: Give yourself some credit
+  details: Wether you are sharing your own or somebody else's code, be sure to include everyone in the credits.
+footer: MIT Licensed | Copyright © 2018-present Planet Laravel
+---

authentication/README.md

@@ -0,0 +1,3 @@
+# Authentication and Authorization
+
+<ItemList />

authentication/ajax-login.md

@@ -0,0 +1,25 @@
+# Using Ajax for user authentication
+
+If you are building an Ajax based login form you can use the `authenticated` method to send an ajax response instead of the default Laravel redirect.
+
+```php
+// LoginController.php
+
+...
+    /**
+     * The user has been authenticated.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @param  mixed  $user
+     * @return mixed
+     */
+    protected function authenticated(Request $request, $user)
+    {
+        // Send required response here
+    }
+...
+```
+
+|Added by|Found via|
+|--------|--------|
+|[Marco Mark](https://twitter.com/m2de_io)|[Medium](https://codeburst.io/using-ajax-user-login-in-laravel-5-3-5-4-5-5-5-6-d4e30b47985f)|

database/README.md

@@ -0,0 +1,3 @@
+# Eloquent Databases
+
+<ItemList />

database/array-where-conditions.md

@@ -0,0 +1,31 @@
+---
+snippet: |
+    User::where([
+        'confirmed' => true,
+        'active' => true,
+    ]);
+---
+
+# You can pass an array of constraints to the "where" method
+
+Did you know that you can pass an array of constraints to the "where" method on Laravel's query builder?
+
+```php
+User::where([
+    'confirmed' => true,
+    'active' => true,
+]);
+```
+
+You can even include operators ...
+
+```php
+User::where([
+    ['confirmed_at', '!=', null],
+    'active' => true,
+]);
+```
+
+|Added by|Found via|
+|--------|--------|
+|[Marco Mark](https://twitter.com/m2de_io)|[Joseph Silber](https://mobile.twitter.com/joseph_silber/status/1017394114185388032)|

database/easy-subqueries-select-sub.md

@@ -0,0 +1,35 @@
+# Subqueries made easy with `selectSub`
+
+Subqueries allow us to select extra columns (attributes) right in our primary database query.
+
+```php
+$lastLogin = Login::select('created_at')
+    ->whereColumn('user_id', 'users.id')
+    ->latest()
+    ->limit(1)
+    ->getQuery();
+
+$users = User::select('users.*')
+    ->selectSub($lastLogin, 'last_login_at')
+    ->get();
+```
+
+```php
+@foreach ($users as $user)
+    <tr>
+        <td>{{ $user->name }}</td>
+        <td>{{ $user->email }}</td>
+        <td>
+            @if ($user->last_login_at)
+                {{ $user->last_login_at->format('M j, Y \a\t g:i a') }}
+            @else
+                Never
+            @endif
+        </td>
+    </tr>
+@endforeach
+```
+
+|Added by|Found via|
+|--------|--------|
+|[Marco Mark](https://twitter.com/m2de_io)|[Jonathan Reinink](https://reinink.ca/articles/dynamic-relationships-in-laravel-using-subqueries)|

generic/README.md

@@ -0,0 +1,3 @@
+# Generic tips and tricks
+
+<ItemList />

generic/factory-methods-constructors.md

@@ -0,0 +1,23 @@
+# Consider static factory methods instead of constructors
+
+Unlike constructors, static factory methods can have names making the code easier to read - the DateTime class in PHP is a good example.
+
+This is much more expressive ...
+
+```php
+$format = 'Y-m-d H:i:s';
+
+$date = DateTime::createFromFormat($format, '2018-07-28 13:37:00');
+```
+
+than this ...
+
+```php
+$format = 'Y-m-d H:i:s';
+
+$date = new DateTime($format, '2018-07-28 13:37:00');
+```
+
+|Added by|Found via|
+|--------|--------|
+|[Marco Mark](https://twitter.com/m2de_io)|[Nuno Maduro](https://mobile.twitter.com/enunomaduro/status/1077879686695448576)|

generic/throw_if_throw_unless.md

@@ -0,0 +1,15 @@
+# Get rid of unnecessary conditionals with `throw_if` and `throw_unless`
+
+Make use of more expressive code using the "throw_if" and "throw_unless" helper functions in Laravel PHP
+
+```php
+// throw an exception if the condition is true
+throw_if($condition = true, new SomeException);
+
+// throw an exception unless the condition is true
+throw_unless($condition = true, new SomeException);
+```
+
+|Added by|Found via|
+|--------|--------|
+|[Marco Mark](https://twitter.com/m2de_io)|[Marcel Pociot](https://mobile.twitter.com/marcelpociot/status/1075744056679038976)|

interfaces/README.md

@@ -0,0 +1,3 @@
+# Interfaces and its use cases
+
+<ItemList />

interfaces/responsible-view-objects.md

@@ -0,0 +1,38 @@
+# Using the responsible interface to build dedicated view objects
+
+Dedicated view objects are a great use case for Laravel 5.5's new `Responsable` interface.
+
+Let's take this pseudo controller which actually returns a rendered view with specific parameters.
+
+```php
+class ProductSalesController
+{
+    public function show(Product $product)
+    {
+        return new SalesReport($product);
+    }
+}
+```
+
+The implementation is a simple class which implements the Responsible interface.
+
+```php
+class SalesReport implements Responsible
+{
+    ...
+
+    public function totalRevenue()
+    {
+        return $this->product->sales->sum('amount');
+    }
+
+    public function toResponse()
+    {
+        return view('product-sales.show')->with('total_revenue', $this->totalRevenue());
+    }
+}
+```
+
+|Added by|Found via|
+|--------|--------|
+|[Marco Mark](https://twitter.com/m2de_io)|[Adam Wathan](https://mobile.twitter.com/adamwathan/status/897836363885797376)|

models/README.md

@@ -0,0 +1,3 @@
+# Things you didn't know you can do with Models
+
+<ItemList />

models/boot-trait.md

@@ -0,0 +1,36 @@
+# Hook into model events from a trait
+
+You can hook into a model's boot method from your trait by creating a `boot{TraitName}` method. This is somewhat hidden in the [official documentation](https://laravel.com/docs/5.0/eloquent#global-scopes).
+
+Here's a basic example of how you could use this functionality.
+
+```php
+trait NotifyWhenCreated
+{
+    public static function bootNotifyWhenCreated()
+    {
+        static::created(function ($item) {
+            Notification::send($recipients, new ItemCreated($item));
+        });
+    }
+}
+```
+
+Add the trait to your model.
+
+```php
+class User extends Eloquent
+{
+    use NotifyWhenCreated;
+}
+```
+
+Use your new functionality.
+
+```php
+User::create([...]); // Your notification will be sent
+```
+
+|Added by|Found via|
+|--------|--------|
+|[Marco Mark](https://twitter.com/m2de_io)|[Laravel Docs](https://laravel.com/docs/5.0/eloquent#global-scopes)|

models/initialize-trait.md

@@ -0,0 +1,41 @@
+# Hook into the __construct() method of a model from a trait
+
+Since 5.7, Laravel will automatically look for and execute any `initialize{TraitName}` methods when a model instance is created, givin you full access to the object (e.g. `$this`).
+
+Create a trait with the initialize function and perform whatever logic you need.
+
+```php
+trait HasMembership
+{
+    // Use the initialize{TraitName} convention
+    public function initializeHasMembership
+    {
+        $this->casts = array_merge($this->casts, [
+            'membership_started_at' => 'datetime',
+        ]);
+    }
+}
+```
+
+Add the trait to your model.
+
+```php
+class User extends Eloquent
+{
+    use HasMembership;
+
+    protected $casts = [
+        'age' => 'int',
+    ];
+}
+```
+
+Use your new functionality.
+
+```php
+User::first()->membership_started_at; // Carbon Instance
+```
+
+|Added by|Found via|
+|--------|--------|
+|[Marco Mark](https://twitter.com/m2de_io)|[Tim MacDonald](https://twitter.com/timacdonald87/status/1076117855911866369)|