Add content about blade directives for views.

Author: MimisK13

docs/.vuepress/config.js

@@ -43,6 +43,25 @@ module.exports = {
 						children : [
 							'/php/laravel/authorization/gates.md',
 							'/php/laravel/authorization/policies.md',
+
+							{
+								title: 'Blade Directives',
+								path: '/php/laravel/authorization/blade-directives/',
+								children: [
+									{
+										title: '@can',
+										path: '/php/laravel/authorization/blade-directives/can.md',
+									},
+									{
+										title: '@cannot',
+										path: '/php/laravel/authorization/blade-directives/cannot.md',
+									},
+									{
+										title: '@canany',
+										path: '/php/laravel/authorization/blade-directives/canany.md',
+									},
+								],
+							},
 						],
 					},
 					{

docs/php/laravel/authorization/blade-directives/README.md

@@ -0,0 +1,130 @@
+# Blade Authorization Directives for View Security
+
+Laravel's Blade authorization directives integrate seamlessly with your application's 
+permission system, enabling clean conditional rendering based on user capabilities. 
+These directives maintain consistency between backend authorization and frontend display logic.
+
+Blade provides three primary authorization directives for permission checking:
+
+```php
+@can('edit', $article)
+    <button class="edit-btn">Edit Article</button>
+@endcan
+ 
+@cannot('delete', $article)
+    <span class="text-muted">Deletion not permitted</span>
+@endcannot
+```
+
+The `@canany` directive checks multiple permissions simultaneously, useful for complex authorization scenarios.
+
+```php
+@canany(['publish', 'schedule'], $article)
+    <div class="publishing-controls">
+        Publishing options available
+    </div>
+@endcanany
+```
+
+Here's a comprehensive dashboard implementation showcasing various authorization patterns:
+
+```php
+<div class="dashboard-layout">
+    <header class="dashboard-header">
+        <h1>Content Management</h1>
+ 
+        @canany(['create-posts', 'create-pages'])
+            <div class="create-actions">
+                @can('create-posts')
+                    <a href="{{ route('posts.create') }}" class="btn btn-primary">New Post</a>
+                @endcan
+ 
+                @can('create-pages')
+                    <a href="{{ route('pages.create') }}" class="btn btn-secondary">New Page</a>
+                @endcan
+            </div>
+        @endcanany
+    </header>
+ 
+    <main class="content-area">
+        @foreach($articles as $article)
+            <article class="content-card">
+                <h2>{{ $article->title }}</h2>
+                <p>{{ $article->excerpt }}</p>
+ 
+                <div class="article-meta">
+                    <span>By {{ $article->author->name }}</span>
+                    <span>{{ $article->published_at->diffForHumans() }}</span>
+                </div>
+ 
+                <div class="article-actions">
+                    @can('update', $article)
+                        <a href="{{ route('articles.edit', $article) }}" class="action-link">
+                            Edit
+                        </a>
+                    @endcan
+ 
+                    @can('publish', $article)
+                        @if($article->is_draft)
+                            <form method="POST" action="{{ route('articles.publish', $article) }}" class="inline-form">
+                                @csrf
+                                <button type="submit" class="publish-btn">Publish</button>
+                            </form>
+                        @endif
+                    @endcan
+ 
+                    @cannot('delete', $article)
+                        <span class="disabled-action">Delete (Protected)</span>
+                    @else
+                        <form method="POST" action="{{ route('articles.destroy', $article) }}" class="inline-form">
+                            @csrf
+                            @method('DELETE')
+                            <button type="submit" class="delete-btn" onclick="return confirm('Delete this article?')">
+                                Delete
+                            </button>
+                        </form>
+                    @endcannot
+                </div>
+            </article>
+        @endforeach
+    </main>
+ 
+    <aside class="sidebar">
+        @canany(['view-analytics', 'manage-users', 'system-settings'])
+            <div class="admin-panel">
+                <h3>Administration</h3>
+                <ul class="admin-links">
+                    @can('view-analytics')
+                        <li><a href="{{ route('analytics.dashboard') }}">Analytics</a></li>
+                    @endcan
+ 
+                    @can('manage-users')
+                        <li><a href="{{ route('users.index') }}">User Management</a></li>
+                    @endcan
+ 
+                    @can('system-settings')
+                        <li><a href="{{ route('settings.index') }}">System Settings</a></li>
+                    @endcan
+                </ul>
+            </div>
+        @endcanany
+ 
+        @guest
+            <div class="login-prompt">
+                <p>Please <a href="{{ route('login') }}">login</a> to access all features.</p>
+            </div>
+        @else
+            @cannot('create-posts')
+                <div class="upgrade-notice">
+                    <p>Upgrade your account to create posts.</p>
+                    <a href="{{ route('plans.index') }}" class="upgrade-link">View Plans</a>
+                </div>
+            @endcannot
+        @endguest
+    </aside>
+</div>
+```
+
+Authorization directives ensure that UI elements align with user permissions, creating secure and intuitive interfaces while reducing the risk of exposing unauthorized functionality.
+
+[source](https://laravel-news.com/blade-authorization-can-cannot)

docs/php/laravel/authorization/blade-directives/can.md

@@ -0,0 +1,56 @@
+# @can
+
+Το `@can` είναι Blade directive που χρησιμοποιείται για **conditional rendering στο view layer** βάσει του Laravel authorization system (policies ή gates).  
+Εμφανίζει το περιεχόμενο **μόνο αν ο authenticated user έχει το συγκεκριμένο ability**.
+
+---
+
+[[TOC]]
+
+---
+
+## Usage examples
+
+### Model-based policy
+
+```php
+@can('update', $post)
+    <button>Edit</button>
+@endcan
+```
+
+### Class-level ability
+
+```php
+@can('create', \App\Models\Post::class)
+    <a href="{{ route('posts.create') }}">New Post</a>
+@endcan
+```
+
+### With else
+
+```php
+@can('delete', $post)
+    <button>Delete</button>
+@else
+    <span>Not allowed</span>
+@endcan
+```
+
+### Gate-based ability
+
+```php
+@can('access-admin')
+    <x-admin-panel />
+@endcan
+```
+
+### Wrapping components
+
+```php
+@can('viewAny', \App\Models\Post::class)
+    <livewire:posts-table />
+@endcan
+```
+
+💡 Το `@can` καλεί εσωτερικά το Gate::check() και δεν αντικαθιστά authorization σε controllers ή actions — είναι καθαρά για UI logic.

docs/php/laravel/authorization/blade-directives/canany.md

@@ -0,0 +1,63 @@
+# @canany
+
+
+Το @canany είναι Blade directive που χρησιμοποιείται για conditional rendering όταν ο χρήστης έχει **ΤΟΥΛΑΧΙΣΤΟΝ ΕΝΑ** από πολλά abilities.
+
+Χρησιμοποιείται όταν ένα UI element πρέπει να εμφανίζεται αν ο χρήστης έχει **οποιοδήποτε** από τα επιτρεπόμενα permissions.
+
+---
+
+[[TOC]]
+
+---
+
+## Usage examples
+
+### Model-based policy (multiple abilities)
+
+```php
+@canany(['update', 'publish'], $post)
+    <button>Edit or Publish</button>
+@endcanany
+```
+
+### Class-level abilities
+
+```php
+@canany(['create', 'import'], \App\Models\Post::class)
+    <a href="{{ route('posts.create') }}">New Post</a>
+@endcanany
+```
+
+### Gate-based abilities
+
+```php
+@canany(['access-admin', 'access-moderator'])
+    <x-admin-panel />
+@endcanany
+```
+
+### Wrapping components
+
+```php
+@canany(['viewAny', 'export'], \App\Models\Post::class)
+    <livewire:posts-table />
+@endcanany
+```
+
+### Combined UI logic
+
+```php
+@can('delete', $post)
+    <button>Delete</button>
+@endcan
+```
+
+```php
+@canany(['restore', 'forceDelete'], $post)
+    <button>Advanced actions</button>
+@endcanany
+```
+
+💡 Το @canany επιστρέφει true αν **οποιοδήποτε** από τα abilities επιτρέπεται από το authorization system (policies / gates).  
+Χρησιμοποιείται αποκλειστικά στο view layer.

docs/php/laravel/authorization/blade-directives/cannot.md

@@ -0,0 +1,62 @@
+# @cannot
+
+Το @cannot είναι Blade directive που χρησιμοποιείται για conditional rendering όταν ο χρήστης ΔΕΝ έχει ένα συγκεκριμένο ability.
+Αποτελεί το λογικό αντίθετο του @can και είναι χρήσιμο για fallback UI, μηνύματα περιορισμών ή alternative actions.
+
+---
+
+[[TOC]]
+
+---
+
+## Usage examples
+
+### Model-based policy
+
+```php
+@cannot('update', $post)
+    <span>You cannot edit this post.</span>
+@endcannot
+```
+
+### Class-level ability
+
+```php
+@cannot('create', \App\Models\Post::class)
+    <p>You are not allowed to create posts.</p>
+@endcannot
+```
+
+### Gate-based ability
+
+```php
+@cannot('access-admin')
+    <x-alert type="warning">
+        Admin access required
+    </x-alert>
+@endcannot
+```
+
+### Wrapping fallback components
+
+```php
+@cannot('viewAny', \App\Models\Post::class)
+    <empty-state message="No access to posts" />
+@endcannot
+```
+
+### Inverse UI logic
+
+```php
+@can('delete', $post)
+    <button>Delete</button>
+@endcan
+```
+
+```php
+@cannot('delete', $post)
+    <span>Deletion disabled</span>
+@endcannot
+```
+
+💡 Το @cannot είναι απλώς το inverse του @can και βασίζεται στο ίδιο authorization system (policies / gates). Χρησιμοποιείται αποκλειστικά στο view layer.