Join the official Atom CMS Discord server

Table of Contents

• Disclaimer
• Introduction
• Technologies
• Learning Laravel
• Why Atom CMS?
• Migrating from Another CMS
• Setup Guide
  • Requirements
  • Windows Setup
  • Linux Setup
• Using HTTPS
• Disable Rocket Loader
• Feature Add-ons
• Credits

Disclaimer

Please note that Atom CMS is provided as an educational resource for learning purposes only. The creators and contributors to Atom CMS are not responsible for any misuse or unintended consequences arising from the use of Atom CMS. By using Atom CMS, you agree to take full responsibility for your actions and any consequences resulting from your use of Atom CMS. It is your responsibility to ensure that you are using Atom CMS in compliance with all applicable laws and regulations.

Introduction

Atom CMS is a Habbo Retro CMS, designed to provide the best possible experience for both you and your users. With a focus on community input and easy customization, Atom CMS is built using modern and robust technologies to ensure a smooth and enjoyable experience.

Technologies

Atom CMS is built with the following technologies:

• PHP (Laravel 9.x)
  • Laravel docs
• Vite
  • Vite docs
• TailwindCSS
  • Tailwind docs

You can also use any CSS framework you prefer or even go fully vanilla, thanks to the built-in theme system that Atom CMS offers.

Learning Laravel

If you are new to Laravel and want to build your own features, we highly recommend the following free resources:

• Laravel Bootcamp: https://bootcamp.laravel.com/
• Laravel 8 from Scratch: https://laracasts.com/series/laravel-8-from-scratch
• What's New in Laravel 9: https://laracasts.com/series/whats-new-in-laravel-9

Laracasts is an official learning platform for Laravel, so you can trust the quality of the content and learn best practices from some of the best and most experienced teacher within the field.

Why Atom CMS?

Atom CMS wad made with the community in mind, valuing community input and collaboration. Our goal is to provide a modern and robust CMS using industry-approved technologies, which is easy to understand and work with. Additionally, Atom CMS includes a built-in theme system, making it simple to create or customize themes for your hotel.

We also wanted to widen the options people had when it came to choosing what CMS they wanted to use for their new journey, which was a huge part of the decision of creating Atom CMS.

Migrating from Another CMS

If you're migrating from another CMS like Cosmic CMS and is unsure what tables to remove or worry about colliding tables names, then fear no more!

Even tho we highly recommend to do a proper cleanup yourself, Atom CMS has a built-in option to rename colliding table names and drop matching foreign keys.

All you have to do is to change RENAME_COLLIDING_TABLES=false to RENAME_COLLIDING_TABLES=true within your .envfile (You'll get to the .env file in the next step). Once the feature is enabled, Atom CMS will attempt to solve any conflicts that might happen due to the use of another CMS.

Requirements

• PHP 8.1 or above PHP Downloads
• MySQL >= 8.x or MariaDB >= 10.x
• Composer v2 Composer Download
• NPM (LTS) Node Download
• An Arcturus Morningstar database Database repository

Please verify the following extensions are enabled inside your php.ini file. If they have a ";" in front of them it means that they're commented out and not enabled. Simply remove the ";" to enable them.

extension=curl
extension=fileinfo
extension=gd
extension=mbstring
extension=openssl
extension=pdo_mysql
extension=sockets

Windows Setup

git clone https://github.com/ObjectRetros/atomcms.git
cd atomcms
copy .env.example .env (Do not forget to edit the database credentials inside the .env)
composer install 
npm install && npm run build:atom (For development run: npm run dev:[theme-name] - eg. npm run dev:atom)
php artisan key:generate
php artisan migrate --seed

Don't forget to link your IIS site to the "public" folder inside for "atomcms"

If you are using Atom CMS in production, don't forget to change the following variables:

APP_ENV=local to APP_ENV=production
APP_DEBUG=true to APP_DEBUG=false

Required permissions

Please make sure the "atomcms" folder is granted "Full control" for both the IUSR & the IIS_IUSRS.

Here's a GIF of me doing it on a different folder: https://gyazo.com/7d5f38525a762c1b26bbd7552ca93478 the principle is the same, you just do it on the "atomhk" folder.

cURL error

If you're receiving a cURL 60 error due to eg. setting up findretros, then make sure you download the latest cacert.pem from https://curl.se/docs/caextract.html. Once downloaded place it in eg. "C:/" folder and then open your php.ini file, search for curl.cainfo uncomment (Remove the ";" infront of the line) it and put the absolute path + file name to your certificate (Eg. "C:/cacert-2022-07-19.pem"). Save the file and your problem should now be solved.

Windows Tutorial

Have you always wanted to set up your own hotel from scratch, but are unsure how? Then you can follow my three parts series on DevBest which will take you through any step necessary to get everything up and running.

• Part 1: https://devbest.com/threads/how-to-set-up-a-retro-in-2022-iis-nitro-html5-part-1.92532/
• Part 2: https://devbest.com/threads/how-to-set-up-a-retro-in-2022-iis-nitro-html5-part-2.92533/
• Part 3: https://devbest.com/threads/how-to-set-up-a-retro-in-2022-iis-nitro-html5-part-3.92543/

Linux Setup

git clone https://github.com/ObjectRetros/atomcms.git
cd atomcms
cp .env.example .env (Do not forget to edit the database credentials inside the .env)
composer install
npm install && npm run build:atom (For development run: npm run dev:[theme-name] - eg. npm run dev:atom)
php artisan key:generate
php artisan migrate --seed

Grant necessary permissions to used folders. Within your atomcms directory, enter the 4 commands below:

sudo chown -R $USER:www-data storage
sudo chown -R $USER:www-data bootstrap/cache
chmod -R 775 storage
chmod -R 775 bootstrap/cache

For NGINX, you can copy the config a base configuration from here: Deploy a site on nginx

If you are using Atom CMS in production, don't forget to change the following variables:

APP_ENV=local to APP_ENV=production
APP_DEBUG=true to APP_DEBUG=false

Using HTTPS

In case you're using HTTPs through Cloudflares "Always redirect to HTTPs" feature, you should set FORCE_HTTPS= within your .env file to true this it to make sure everything is properly using HTTPs. This is necessary for some features in Atom CMS to work properly when you're letting cloudflare handle the HTTPs redirects without a dedicated SSL certificate.

Disable rocket loader

Atom CMS uses Javascript in certain areas, which unfortunately conflicts with Cloudflares Rocket Loader feature. So in-case you have Rocket Loader enabled on Cloudflare, you will have to disable it, otherwise you will run into various annoying issues when using Atom CMS.

To disable or check if Rocket Loader is enabled on Cloudflare, all you have to do is, head to your Cloudflare dashboard and find "Speed" -> "Optimization" in the navigation menu, once you've clicked on the "Optimization" menu point, scroll about halfway down until you find "Rocket Loader™" and then un-toggle it in-case it's enabled. That's it! Rocket loader is now disabled, and you're all good to go.

Feature-addons

Atom comes with its own dedicated documentation site - this makes it a lot easier for you to read about exactly what you want, rather than having to read through a giant README file!

As Atom CMS comes packed with tons of features, to improve the CMS experience for you and your users it only makes sense to have such a site to make the experience the best possible.

You can find the documentation, addons, and tips & tricks on https://retros.guide/docs/category/atom-cms

Credits

Atom CMS is made possible by the contributions of numerous developers, designers, and community members.

• Kasja - Helping with design, ideas & GFX
• Nicollas - Dark mode, Turbolinks, Performance improvements, Article reactions, User sessions, Layout improvements & PT-BR translations
• Dominic - Performance improvements & User sessions
• Oliver - Profile page & Finnish translations
• Beny - Findretros API fixes & CF Fixes
• Live - French translations, bugfixes & tweaks
• MisterDeen - Custom Discord widget, bugfixes & tweaks
• DamienJolly - Bugfixes
• Danbo - Bugfixes
• Diddy/Josh - Code readability improvements
• Damue - German translations
• Talion - Turkish translations
• CentralCee & Rille - Swedish translations
• Yannick - Netherland translations
• Gedomi - Spanish translations
• Lorenzune - Italian translations
• Twana - Norwegian translations
• Kani - Rcon System & Findretros API
• Sonay - Material theme
• Raizer - Circinus