feat: update with new mvc version docs

Author: mychidarko

.vitepress/config/sidebar.ts

@@ -161,7 +161,7 @@ const sidebar = [
       { text: 'Factories', link: '/docs/database/factories' },
       { text: 'Writing Commands', link: '/docs/mvc/commands' },
       // { text: 'Mailing', link: '/docs/utils/mail/mvc' },
-      { text: 'MVC Helpers', link: '/docs/mvc/globals' },
+      { text: 'MVC Globals', link: '/docs/mvc/globals' },
       { text: 'Custom Libraries', link: '/docs/mvc/libraries' },
       { text: 'MVC Console Tool', link: '/docs/mvc/console' },
     ],

.vitepress/theme/components/shared/Banner.vue

@@ -31,7 +31,7 @@ const dismiss = () => {
 <template>
   <div ref="el" class="banner">
     <div class="text">
-      WARNING You're browsing the documentation for an upcoming version of Leaf. The documentation and features of this release are subject to change.
+      🎉 Leaf MVC v3.8 released. Check out the <a href="https://blog.leafphp.dev/posts/leaf-mvc-3-8" target="_blank">release post</a>
     </div>
 
     <button type="button" @click="dismiss">

.vitepress/theme/index.ts

@@ -1,4 +1,4 @@
-import { h } from 'vue';
+import { defineAsyncComponent, h } from 'vue';
 import DefaultTheme from 'vitepress/theme';
 import { VueWriter } from 'vue-writer';
 import { MotionPlugin } from '@vueuse/motion';
@@ -15,8 +15,8 @@ export default {
   },
   Layout() {
     return h(DefaultTheme.Layout, null, {
-      // 'layout-top': () =>
-      //   h(defineAsyncComponent(() => import('./components/shared/Banner.vue'))),
+      'layout-top': () =>
+        h(defineAsyncComponent(() => import('./components/shared/Banner.vue'))),
     });
   },
 };

src/docs/database/factories.md

@@ -10,7 +10,7 @@ Factories are a way to conveniently generate large amounts of database records.
 
 To create a factory, you can use the `g:factory` command. This command will create a new factory class in the `app/database/factories` directory.
 
-```bash
+```bash:no-line-numbers
 php leaf g:factory UserFactory
 ```
 
@@ -58,7 +58,7 @@ This factory class defines the attributes for the `User` model. The `definition`
 
 To use a factory to generate records, you can use the `create` method on the factory class. This method will create a new record in the database using the attributes defined in the factory.
 
-```php
+```php:no-line-numbers
 (new UserFactory)->create(20)->save();
 ```
 
@@ -92,14 +92,14 @@ This will generate 20 records in the `users` table using the attributes defined
 
 In some cases, you may not want to save the generated records to the database. You can use the `get()` method to get the generated data without saving it to the database.
 
-```php
+```php:no-line-numbers
 $users = (new UserFactory)->create(20)->get();
 ```
 
 ## Running Factories
 
 You don't need to run factories manually. You can use the `db:seed` command to run your seeders, which will in turn run your factories.
 
-```bash
+```bash:no-line-numbers
 php leaf db:seed
 ```

src/docs/database/index.md

@@ -49,6 +49,41 @@ Databases are essential for most applications, as they help you store and retrie
 
 :::
 
+## Leaf MVC + DB
+
+Leaf MVC comes with built-in support for models which are a way to programmatically represent resources in your database using PHP classes. For that reason, you have no real need for this module unless you want to use Leaf Auth. If you choose to use Leaf DB in your MVC application, we have already set up everything for you. All you need to do is to head over to your `.env` file and set up your database connection details. Here are a few example connections:
+
+::: code-group
+
+```txt [MySQL]
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=LeafMVC
+DB_USERNAME=root
+DB_PASSWORD=
+```
+
+```txt [PostgreSQL]
+DB_CONNECTION=pgsql
+DB_HOST=127.0.0.1
+DB_PORT=5432
+DB_DATABASE=LeafMVC
+DB_USERNAME=root
+DB_PASSWORD=
+```
+
+```txt [SQLite]
+DB_CONNECTION=sqlite
+DB_DATABASE=/absolute/path/to/database.sqlite
+```
+
+:::
+
+Remember to head over to `public/index.php` and uncomment the line that says `\Leaf\Database::initDb();`. This will automatically connect to your database using the details in your environment file.
+
+You can safely skip the "Connecting to a database" section.
+
 ## Connecting to a database
 
 The first step to using a database is to create a connection. It's like opening a door to the database, allowing you to interact with it. Here's how you can connect to a database using Leaf:
@@ -100,44 +135,13 @@ db()->connect([
 
 :::
 
-If you are using Leaf MVC, we have already set up everything for you. All you need to do is to head over to your `.env` file and set up your database connection details.
-
-::: code-group
-
-```txt [MySQL]
-DB_CONNECTION=mysql
-DB_HOST=127.0.0.1
-DB_PORT=3306
-DB_DATABASE=LeafMVC
-DB_USERNAME=root
-DB_PASSWORD=
-```
-
-```txt [PostgreSQL]
-DB_CONNECTION=pgsql
-DB_HOST=127.0.0.1
-DB_PORT=5432
-DB_DATABASE=LeafMVC
-DB_USERNAME=root
-DB_PASSWORD=
-```
-
-```txt [SQLite]
-DB_CONNECTION=sqlite
-DB_DATABASE=/absolute/path/to/database.sqlite
-```
-
-:::
-
-Remember to head over to `public/index.php` and uncomment the line that says `\Leaf\Database::initDb();`. This will automatically connect to your database using the details in your environment file.
-
 ## Writing simple queries
 
 Once you've connected to a database, you can start writing queries to interact with it. Queries are the commands you run on your database to get, insert, update or delete data. Leaf DB provides a simple way to run queries using the query builder, but also allows you to run raw SQL queries.
 
 We can run queries using the `query()` method. This method takes in a query string and returns a query builder instance. This means that you can run queries like this:
 
-```php
+```php:no-line-numbers
 $users = db()->query('SELECT * FROM users')->all();
 ```
 
@@ -158,13 +162,13 @@ There are different kinds of database commands: some give you results (like data
 
 You can use `execute()` to run queries that don't return values. This method returns `true` if the query was successful and `false` if it wasn't. You can run a query like this:
 
-```php
+```php:no-line-numbers
 db()->query('CREATE DATABASE dbname')->execute();
 ```
 
 If you want to run a query that returns data, you can use the `all()` method to get all the results. For example, you can run a query like this:
 
-```php
+```php:no-line-numbers
 $users = db()->query('SELECT * FROM users')->all();
 ```
 
@@ -183,6 +187,6 @@ This will return the matched user as an object.
 
 There may be times when you want to get a single value from a query that returns multiple rows. In such cases, you can use the `first()` method. For example, you can run a query like this:
 
-```php
+```php:no-line-numbers
 $user = db()->query('SELECT * FROM users')->first();
 ```

src/docs/database/models.md

@@ -51,7 +51,7 @@ This code will retrieve all rows from the `flights` table and then loop through
 
 The Leaf all method will return all of the results in the model's table. Since each Leaf model serves as a query builder, you may also add constraints to queries, and then use the get method to retrieve the results:
 
-```php
+```php:no-line-numbers
 $flights = Flight::where('active', 1)->orderBy('name', 'desc')->take(10)->get();
 ```
 

src/docs/http/cors.md

@@ -79,6 +79,24 @@ app()->cors([
 
 This will allow `http://example.com`, `https://example.com`, `http://www.example.com`, and `https://some-subdomain.example.com` to access your app. Of course, you can also use a regular expression to match multiple domains. You can find a full list of options below.
 
+## CORS + Leaf MVC
+
+If you are using Leaf MVC, you can configure CORS using your environment variables in place of the configuration above:
+
+```txt:no-line-numbers [.env]
+CORS_ALLOWED_ORIGINS='/\.example\.com$/'
+CORS_ALLOWED_METHODS='GET,HEAD,PUT,PATCH,POST,DELETE'
+CORS_ALLOWED_HEADERS='*'
+```
+
+While this is easier and allows you to easily configure different environments, it can sometimes be limiting for example when you want to return a function for dynamically set your allowed origins. For this reason, you can publish your CORS configuration using the command below:
+
+```bash:no-line-numbers
+php leaf config:publish cors
+```
+
+This will create or update your CORS config in `config/cors.php`. You can then use the options below to configure the CORS module to suit your exact needs.
+
 ## Configuration Options
 
 The `cors()` method takes in an array of options. Here are the available options:

src/docs/http/headers.md

@@ -122,7 +122,7 @@ Leaf\Http\Headers::remove(['WWW-Authenticate', 'Authorization']);
 
 You can check if a header exists using the `Leaf\Http\Headers::has()` method. This method takes in a single parameter, the header to check and returns a boolean.
 
-```php
+```php:no-line-numbers
 $exists = Leaf\Http\Headers::has('Content-Type');
 ```
 

src/docs/mvc/commands.md

@@ -82,7 +82,7 @@ class CachePurgeCommand extends Command
 }
 ```
 
-If you are using Leaf MVC v3.8 and above, the command is automatically loaded by Leaf MVC. If you are using Leaf MVC v3.7 and below, you will need to register the command in the `app/console/Commands.php` file.n
+If you are using Leaf MVC v3.8 and above, the command is automatically loaded by Leaf MVC. If you are using Leaf MVC v3.7 and below, you will need to register the command in the `app/console/Commands.php` file.
 
 ```php
 <?php
@@ -112,7 +112,7 @@ class Commands
 
 Command arguments are values that are passed to the command when it is run in the console. For example, if you have a command named `example` and you run it like this:
 
-```bash
+```bash:no-line-numbers
 php leaf example argument
 ```
 
@@ -138,7 +138,7 @@ protected function handle()
 
 Command options are values that are passed to the command when it is run in the console. For example, if you have a command named `example` and you run it like this:
 
-```bash
+```bash:no-line-numbers
 php leaf example --option=value
 ```
 
@@ -371,6 +371,6 @@ This method asks a question but hides the keystrokes. It takes in 2 parameters:
 - the question to ask
 - use hidden fallback (optional)
 
-```php
+```php:no-line-numbers
 $password = $this->secret('Confirm your password');
 ```

src/docs/mvc/console.md

@@ -8,6 +8,20 @@ Leaf MVC includes a powerful command-line tool called Aloe to help you manage yo
 php leaf list
 ```
 
+::: details Missing commands?
+
+If you get errors from commands which you saw in the documentation, you are probably running an older version of the Leaf MVC console. We add more handy commands regularly, but as the console does not automatically update, you may run into the missing command error. To fix that problem, you need to install the latest version of Aloe:
+
+```bash:no-line-numbers
+leaf install aloe
+
+# or with composer
+
+composer require leafs/aloe
+```
+
+:::
+
 ## Aloe vs. Leaf CLI: What's the Difference?
 
 Before diving in, it’s important to know that Aloe is different from Leaf CLI.