# What about building a CMS, let's Twill > **Updated version for Laravel 10 / Twill 3 on Apr 14, 2023** ## Dependencies installation Twill comes as a Laravel package that can be installed via Composer. You can refer to the [official documentation](https://twillcms.com/docs/) for more information. ```bash composer require area17/twill:"^3.0" ``` ## Twill installation #### What does that mean? Twill installation will * Create configuration files * `twill.php`: global configuration of the package * `translatable.php`: Twill uses [astrotomic/laravel-translatable](https://github.com/Astrotomic/laravel-translatable) package to handle multi-language content * Create a `twill.php` route file to declare the routes of our modules * Publish the assets of the administration interface (Twill is built with Vue.js 2) * Migrate all the package tables: twill users, settings, blocks, medias, files, ... * Prompt for a superadmin account creation (you can create it or new ones later with this command `php artisan twill:superadmin`) If you want to change the default table names, create the `twill.php` config file before proceeding to the installation and define your custom names. **Default table names** ```php 'blocks_table' => 'twill_blocks', 'features_table' => 'twill_features', 'fileables_table' => 'twill_fileables', 'files_table' => 'twill_files', 'mediables_table' => 'twill_mediables', 'medias_table' => 'twill_medias', 'password_resets_table' => 'twill_password_resets', 'related_table' => 'twill_related', 'settings_table' => 'twill_settings', 'tagged_table' => 'twill_tagged', 'tags_table' => 'twill_tags', 'users_oauth_table' => 'twill_users_oauth', 'users_table' => 'twill_users', ``` We generally change the table names to set `admin` prefix instead of `twill` for admin users and add `content` prefix for all other tables. **/config/twill.php** ```php 'content_blocks', 'features_table' => 'content_features', 'fileables_table' => 'content_fileables', 'files_table' => 'content_files', 'mediables_table' => 'content_mediables', 'medias_table' => 'content_medias', 'password_resets_table' => 'admin_password_resets', 'related_table' => 'content_related', 'settings_table' => 'content_settings', 'tagged_table' => 'content_tagged', 'tags_table' => 'content_tags', 'users_oauth_table' => 'admin_users_oauth', 'users_table' => 'admin_users', ]; ``` #### Ok, let's do it We have an email address *(no mail will be sent)* and a password, we are ready for the installation process, so let's execute the following command: ```bash php artisan twill:install ``` ## Where is my Twill The administration interface is available by default as `admin` path of your `APP_URL` environment variable (defined when you installed Laravel in your `/.env` file): `http://localhost/admin`. Twill allows you to have it available where you want with environment variables: * For a fully dedicated domain: set an `ADMIN_APP_URL` environment variable with the URL (ex: `ADMIN_APP_URL=tech.codivores.com`) * As a path of your main domain: set an `ADMIN_APP_PATH` environment variable with the name of the subdirectory (ex: `ADMIN_APP_PATH=/administration`). You can find more configuration options in the [official documentation](https://twillcms.com/docs/getting-started/installation.html#content-admin-path-and-domain) like strict domain handling when using a path. In most cases, we make the administration available as a path of the main domain. And depending on our clients, we set the `ADMIN_APP_PATH` environment variable in the `.env` file (or as an OS environment variable) with the name they want and that is not too obvious for an administration interface. /!\\ If you are using a path, there's a little buggy behavior: if you try to login through `http://localhost/admin/login.php` instead of `http://localhost/admin`, you are well logged in but redirected to the `APP_URL`... To prevent this, you can edit the default `auth_login_redirect_path` config: **/config/twill.php** ```php return [ /* |-------------------------------------------------------------------------- | Twill Auth related configuration |-------------------------------------------------------------------------- | */ 'auth_login_redirect_path' => env('ADMIN_APP_PATH', '/admin'), ]; ``` We can now go to `http://localhost/admin` in a browser and see the login page. ![](https://cdn.hashnode.com/res/hashnode/image/upload/v1681485807160/f3df7f2b-397c-419f-87ca-ecd7b14e1e40.png align="center") Filling the login form with the superadmin email and password we set earlier, we can see a beautiful empty administration interface 🙌. ![](https://cdn.hashnode.com/res/hashnode/image/upload/v1681485842850/7401a84c-f3bf-4345-9e7f-e7ed9a7b04c4.png align="center") ## Multi-language configuration Twill allows you to manage your content in multiple languages and also have the administration in different languages. #### Multi-language in the Front Just add your locales in the `locales` array of the [astrotomic/laravel-translatable](https://github.com/Astrotomic/laravel-translatable) package configuration file. We will just add French beside the default English locale for the tutorial. **/config/translatable.php** ```php [ 'en', 'fr', ], ``` #### Multi-language in the Back Twill handles some locales for the administration interface (at this time: `ar, bs, de, en, fr, nl, pl, pt, ru, tr, zh-Hans` - feel free to contribute and add yours). Admin users can choose their language on their profile page, but you can change the default `en` locale in the Twill configuration file if you prefer. **/config/twill.php** ```php 'fr', ``` ## Ready to create content? Go to the next article to create a first module. --- **We now have a basic (for now) but working administration interface to manage content, we will see in later articles how to create content and display it on our front-end with Inertia and handle more complex content structure** --- > We'll do our best to provide source code of the serie on [GitHub](https://github.com/Codivores/tutorial-laravel-twill-inertia-vue3-vite-tailwind) %[https://github.com/Codivores/tutorial-laravel-twill-inertia-vue3-vite-tailwind]