====== Information ======

  * Joomla ((https://www.joomla.org))
  * [[Information:Realm of Espionage]]
  * https://realmofespionage.xyz

===== Prerequisites =====

  * [[windows;10|Windows 10 (21H2)]]
  * [[servers;windows;nginx_php_php-cgi|nginx + PHP + PHP-CGI]]
  * [[servers;windows;nginx;lets_encrypt|Certbot (Let's Encrypt)]]
  * [[programs;windows;git|Git]]
  * [[programs;windows;nodejs_npm|Node.js + npm]]
  * [[servers;windows;mariadb|MariaDB]]

====== Dependencies ======

  * https://docs.joomla.org/What_version_of_Joomla!_should_you_use%3F
  * https://docs.joomla.org/Special:MyLanguage/J5.x:Setting_Up_Your_Local_Environment
  * https://manual.joomla.org/docs/next/get-started/technical-requirements/
  * https://docs.joomla.org/J5.x:Optional_Technical_Requirements

====== Download Source ======

  * https://github.com/joomla/joomla-cms/branches
  * https://github.com/joomla/joomla-cms/commits/6.1-dev/

  "%ProgramFiles%\Git\bin\git.exe" clone --branch "6.1-dev" --depth "1" --recurse-submodules "https://github.com/joomla/joomla-cms.git" "%SystemDrive%\www\main"

====== Database ======

  "%ProgramFiles%\MariaDB 12.2\bin\mariadb.exe" -u "root" -p

  CREATE DATABASE joomla_db;

  CREATE USER 'joomla'@'localhost' IDENTIFIED BY 'x';

  GRANT ALL PRIVILEGES ON joomla_db.* to 'joomla'@'localhost';

  FLUSH PRIVILEGES;EXIT;

====== Environment ======

===== PHP =====

  "notepad.exe" "%SystemDrive%\www\php\main.ini"

<code>
[PHP]
extension_dir = ".\ext"
extension = "curl"
extension = "gd"
extension = "intl"
extension = "ldap"
extension = "mbstring"
extension = "mysqli"
extension = "openssl"
extension = "sodium"

error_reporting = "~E_ALL"
display_errors = "Off"
log_errors = "Off"

post_max_size = "5M"
upload_max_filesize = "5M"

[Date]
date.timezone = "America/New_York"

; End</code>

  "php.exe" -c "%SystemDrive%\www\php\main.ini" -m

===== Composer =====

  * [[https://github.com/composer/composer/releases/latest/download/composer.phar|composer.phar]]

  MKDIR "%SystemDrive%\www\ext"

  "%SystemDrive%\www\ext\composer.phar"

  "php.exe" -c "%SystemDrive%\www\php\main.ini" "%SystemDrive%\www\ext\composer.phar" --version

  CD "%SystemDrive%\www\main" && "php.exe" -c "%SystemDrive%\www\php\main.ini" "%SystemDrive%\www\ext\composer.phar" install --no-dev

===== Node.js =====

****

  CD "%SystemDrive%\www\main" && "%ProgramFiles%\nodejs\node.exe" "%ProgramFiles%\nodejs\node_modules\npm\bin\npm-cli.js" --prefix "%SystemDrive%\www\main" "ci" --verbose

====== nginx + PHP-CGI Configuration ======

===== PHP-CGI =====

  "notepad.exe" "%SystemDrive%\www\nginx\default.d\main.conf"

<code>
location "~" "\.(php)(/.*)?$" {

 fastcgi_split_path_info "^(.+\.(?:php))(/.*)$";
 fastcgi_intercept_errors "on";
 fastcgi_index "index.php";
 include "C:/www/nginx/conf/fastcgi_params";
 fastcgi_param "SCRIPT_FILENAME" "$document_root$fastcgi_script_name";
 fastcgi_param "PATH_INFO" "$fastcgi_path_info";
 fastcgi_param "HTTPS" "on";

 fastcgi_pass "127.0.0.1:9001";

}

# End</code>

===== Server Block =====

  "notepad.exe" "%SystemDrive%\www\nginx\vhosts.d\main.conf"

<code>
server {

 listen "443" "ssl";
 http2 "on";
 server_name "realmofespionage.xyz";
 root "C:/www/main";
 index "index.php";

 include "C:/www/nginx/default.d/main.conf";
 include "C:/www/nginx/default.d/headers.conf";

 client_max_body_size "5M";

# access_log "logs/main-access.log";
# error_log "logs/main-error.log";

 location "/api/" {
  try_files "$uri" "$uri/" "/api/index.php?$args";
 }

 location "/" {
  try_files "$uri" "$uri/" "/index.php?$args";
 }

 location "~*" "/(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$" {
  return "403";
  error_page "403" "/403_error.html";
 }

 location "~*" "\.(ico|pdf|flv)$" {
  expires "1y";
 }

 location "~*" "\.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$" {
  expires "14d";
 }
 
}

# End</code>

  "%SystemDrive%\www\scripts\nginx\Reload.bat"

====== Scripts ======

===== Folder =====

  MKDIR "%SystemDrive%\www\scripts\main"

  "explorer.exe" "%SystemDrive%\www\scripts\main"

===== PHP-CGI =====

  "notepad.exe" "%SystemDrive%\www\scripts\main\PHP-CGI.bat"

<code>
@echo off

SET "PHP_FCGI_MAX_REQUESTS=0"
SET "PHP_FCGI_CHILDREN=1"

START "Main PHP-CGI" /MIN "php-cgi.exe" -b "127.0.0.1:9001" -c "%SystemDrive%\www\php\main.ini" -q

:: End</code>

  "%SystemDrive%\www\scripts\main\PHP-CGI.bat"

===== Update =====

  "notepad.exe" "%SystemDrive%\www\scripts\main\Update.bat"

<code>
@echo off

TITLE Main Updater

"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" reset --hard "origin/6.1-dev"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" pull origin "6.1-dev" --rebase

"php.exe" -c "%SystemDrive%\www\php\main.ini" "%SystemDrive%\www\ext\composer.phar" install --no-dev --working-dir="%SystemDrive%\www\main"

"%ProgramFiles%\nodejs\node.exe" "%ProgramFiles%\nodejs\node_modules\npm\bin\npm-cli.js" --prefix "%SystemDrive%\www\main" "ci"

:: End</code>

  "%SystemDrive%\www\scripts\main\Update.bat"

===== Back-up =====

  * ''D:\Servers\Scheduled Backups''

  "notepad.exe" "%SystemDrive%\www\scripts\main\Back-up.bat"

<code>
@echo off

TITLE Main Back-up

:: User\Downloads
::"tar.exe" -czf "%UserProfile%\Downloads\joomla-files-auto-%RANDOM%.tar.gz" -C "%SystemDrive%\www" "main"
::"%ProgramFiles%\MariaDB 12.2\bin\mariadb-dump.exe" -u "root" --opt -r "%UserProfile%\Downloads\%RANDOM%-joomla.sql" "joomla_db"

:: NAS
"tar.exe" -czf "D:\Servers\Scheduled Backups\joomla-files-auto-%RANDOM%.tar.gz" -C "%SystemDrive%\www" "main"
"%ProgramFiles%\MariaDB 12.2\bin\mariadb-dump.exe" -u "root" --opt -r "D:\Servers\Scheduled Backups\%RANDOM%-joomla.sql" "joomla_db"

:: End</code>

  "%SystemDrive%\www\scripts\main\Back-up.bat"

===== Maintenance =====

  "notepad.exe" "%SystemDrive%\www\scripts\main\Maintenance.bat"

<code>
@echo off

TITLE Main Maintenance

CALL "%SystemDrive%\www\scripts\main\Git Fix.bat"

:: End</code>

  "%SystemDrive%\www\scripts\main\Maintenance.bat"

===== Git Fix =====

  * :!: Set email for ''user.email''

  "notepad.exe" "%SystemDrive%\www\scripts\main\Git Fix.bat"

<code>
@echo off

TITLE Main Git Fix

RMDIR /S /Q "%SystemDrive%\www\main\.git"

"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" init --initial-branch="6.1-dev"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" add "."
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" config "user.email" "espionage724@x"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" commit --message="x"

"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" remote add "origin" "https://github.com/joomla/joomla-cms.git"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" pull --depth "1" --recurse-submodules "origin" "6.1-dev" --rebase
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" reset --hard "origin/6.1-dev"

"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" gc --aggressive --prune="all"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" fsck --full --strict

:: End</code>

  "%SystemDrive%\www\scripts\main\Git Fix.bat"

====== Shortcuts ======

===== Autostart =====

==== PHP-CGI ====

  "explorer.exe" "%AppData%\Microsoft\Windows\Start Menu\Programs\StartUp"

  "%SystemDrive%\www\scripts\main\PHP-CGI.bat"

  Main PHP-CGI

====== Task Scheduler ======

****

  taskschd.msc

===== Update =====

  * ''3:00:00 AM'' daily

  Main Update

  "%SystemDrive%\www\scripts\main\Update.bat"

===== Back-up =====

  * Monthly -> All months -> Days: ''4''
  * ''3:15:00 AM''

  Main Back-up

  "%SystemDrive%\www\scripts\main\Back-up.bat"

===== Maintenance =====

  * Monthly -> All months -> Days: ''4''
  * ''3:30:00 AM''

  Main Maintenance

  "%SystemDrive%\www\scripts\main\Maintenance.bat"

====== Initial Setup ======

  * https://realmofespionage.xyz

====== Settings ======

===== robots.txt =====

****

  COPY /Y "%SystemDrive%\www\main\robots.txt.dist" "%SystemDrive%\www\main\robots.txt"

===== Setup =====

  * System -> Setup -> Global Configuration -> Site -> Site Offline: Enabled
  * System -> Setup -> Global Configuration -> Site -> Offline Message: Use Custom Message

<code>
This site is being built behind-the-scenes, check back later!
<br />
In the meantime, check out my wiki: <a href="https://wiki.realmofespionage.xyz/">RoE | Wiki</a></code>

===== Templates =====

  * System -> Templates -> Site Template Styles -> Cassiopeia Extended - Default: ''[x]''
  * System -> Templates -> Site Template Styles -> Cassiopeia Extended - Default-> Advanced -> Title: ''Realm of Espionage''

==== Theme Settings ====

  * Navigation -> Megamenu Configuration -> Animation: Fading
  * Navigation -> Megamenu Configuration -> Duration: ''300''

  * Add-ons -> Off-canvas Sidebar -> Enable: Off

  * Assignment -> Toggle Selection

==== Footer ====

=== Copyright ===

  * Last tested: 2024/02/01 on Joomla 5.1.0-dev, T3 Framework 3.2.0, and Purity III 2.1.0

== Logo ==

****

  wget -O '/tmp/cc-by-sa-40.png' 'https://licensebuttons.net/l/by-sa/4.0/80x15.png' && sudo mv '/tmp/cc-by-sa-40.png' '/var/www/main/images/cc-by-sa-40.png' && sudo chown 'nginx':'nginx' '/var/www/main/images/cc-by-sa-40.png' && sudo restorecon -F -I -R '/var/www/main/images/cc-by-sa-40.png' && sync

== Text ==

  * Place text within the ''<section class="t3-copyright">'' section underneath the ''Bootstrap by Twitter'' and ''Font Awesome'' mentions
  * Remove ''Bootstrap by Twitter'' and ''Font Awesome'' mentions

  sudo -e '/var/www/main/templates/purity_iii/tpls/blocks/footer.php' && sudo chown 'nginx':'nginx' '/var/www/main/templates/purity_iii/tpls/blocks/footer.php'

<code>
          <small>
            <img src="https://realmofespionage.xyz/images/cc-by-sa-40.png" width="80" height="15" /> All content and data available on Realm of Espionage is available under the <a href="https://creativecommons.org/licenses/by-sa/4.0" target="_blank">Creative Commons Attribution-ShareAlike 4.0 International</a> license.
          </small></code>

==== Custom CSS ====

  * :!: This shrinks the footer height, and places it back at the bottom of the screen instead of floating half-way up the page when little content exists ([[https://www.joomlart.com/forums/topic/footer-on-bottom-of-screen-not-sticky/#post-898349|source 1]], [[https://www.joomlart.com/documentation/joomla-faqs/css-related-issues#footer-sticky|source 2]])
  * Also replaces ThemeMagic for Brand Primary Color, Footer Background, and Footer Text Color

  * Last tested: 2024/02/01 on Joomla 5.1.0-dev, T3 Framework 3.2.0, and Purity III 2.1.0

  sudo -e '/var/www/main/templates/purity_iii/css/custom.css' && sudo chown 'nginx':'nginx' '/var/www/main/templates/purity_iii/css/custom.css'

<code>
html,

body {
  height: 100%;
}

a {
  color: #3D8BFF;
}

a:hover {
  color: #196BE4;
}

.t3-mainnav {
  background-color: #3D8BFF;
}

.logo a {
  background: none;
}

.logo a:hover {
  background: #196BE4;
}

.t3-wrapper {
  position: relative;
  min-height: 100%;
}

.t3-footer {
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  background-color: #484848;
  color: #FFFFFF;
}

.t3-copyright {
  padding-top: 20px;
  padding-bottom: 0px;
}</code>

===== Articles =====

==== Home ====

  * The line-breaks are intentional and are there to make how it displays look nicer
  * Add links to ''RoE | Wiki'' and ''CC BY-SA 4.0 license''

<code> 
 

Welcome! Realm of Espionage is a personal project composed of various services. All services on RoE are free and open-source, self-hosted, and configured with strict security in-mind. My most prominent project currently is RoE | Wiki, a DokuWiki instance that holds my notes on all sorts of operating system, client, and server deployments, free for anyone to view and redistribute under the CC BY-SA 4.0 license.

 

This domain serves as a landing page and provides links to my most-used profiles and projects. To view them, use the navigation bar (desktop) or the ≡ hamburger icon (mobile) at the top of the screen.

 </code>

===== Menus =====

  * Main menu headers are: System Links -> URL -> ''#'' to allow tapping as-expected on mobile
  * Icon sizes are 24x24
  * Menu entries should be named normally before saving for a proper ''alias'', and then add a space on the title afterwards to make it look better with the icon

===== Global Configuration =====

==== Site Meta Description ====

****

  Realm of Espionage is a personal project composed of various self-hosted services. All services are hosted in-house under secure conditions, and notes are provided for all services under the CC-BY-SA 4.0 license.

==== Content Rights ====

****

  Creative Commons Attribution-ShareAlike 4.0 International

==== Articles ====

  * System -> Global Configuration -> Articles

  * Show Title: Hide
  * Show Category: Hide
  * Show Author: Hide
  * Show Publish Date: Hide
  * Show Navigation: Hide
  * Show Print: Hide
  * Show Email: Hide
  * Show Hits: Hide

==== Menu ====

  * Menus -> Main Menu -> Home -> Link Type -> Display in Menu: No
  * Menus -> Main Menu -> Home -> Page Display -> Show Page Heading: Hide

===== configuration.php =====

****

  "notepad.exe" "%SystemDrive%\www\main\configuration.php"

====== Branch Update ======

  * 5.3 -> 5.4

  "%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" switch -t -c "5.4-dev"

  "%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" branch

  "%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" reset --hard 

  "%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\main" pull origin "5.4-dev" --rebase

====== Files ======

===== Backup =====

****

  "tar.exe" -czf "%UserProfile%\Downloads\joomla-files-manual-%RANDOM%.tar.gz" -C "%SystemDrive%\www" "main"

====== Database ======

===== Backup =====

****

  CD "%UserProfile%\Downloads" && "%ProgramFiles%\MariaDB 12.2\bin\mariadb-dump.exe" -u "root" -p --opt -r "joomla.sql" "joomla_db"

===== Restore =====

  * [[#database|Initial set-up]]

  "%ProgramFiles%\MariaDB 12.2\bin\mariadb.exe" -u "root" -p --execute="CREATE DATABASE joomla_db"

  "%ProgramFiles%\MariaDB 12.2\bin\mariadb.exe" -u "root" -p "joomla_db" < "%UserProfile%\Downloads\joomla.sql"