====== Installation ======

===== Joomla Core =====
  - Download the latest [[https://downloads.joomla.org/|Joomla]] core package, unzip to your web host, and run the installer.
  - Select UK English as default and install the language packs for French, German, Korean, and Thai. Activate the multilingual feature without localised content.
  - Publish **Main Menu** for all languages, and unpublish the menus for language localized content.
  - Set Website Timezone in Global Configuration.
  - Set Mail Settings in Global Configuration. 

===== Authentication =====
  - Enable the "Two Factor Authentication - Google Authenticator" plugin in the back-end, Extensions --> Plugins, Site Sections "Administrator", other settings unchanged.
  - Go to Users --> Manage, select the administrator user, then set Authentication Method to "Google Authenticator". Scan the QR code in your smartphone app or take a note of the One time emergency passwords.
  - Enable [[https://docs.joomla.org/J3.x:Google_ReCaptcha#For_Contact_forms_and_the_Registration_form|Google ReCaptcha]]

===== Prepare for migration =====
  - Change the user id of the super user (first user) to the same id as in your previous Joomla installation in db table %%#__users%%
  - On a fresh install, update %%#__categories, #__tags, and #__user_usergroup_map%% (see [[https://github.com/joomla/joomla-cms/blob/3.8.3/installation/model/database.php#L925-L976|Method to update the user id]])
  - reset the users table autoincrement
  - copy field %%#__users: otpKey%% to allow two-factor authentication with the same key on different sites

===== Prepare ACL =====
  - Create **User Groups**
    * parent registered: captain, co-captain
    * parent administrator: president, vice-president, treasurer, secretary
    * parent super users: webadmin, webmaster
    * parent editor: publisher (as per default install, used for translations)
  - Create **Viewing Access Levels** (id=# is mandatory)
    * Guest, id=5, User Groups Having Viewing Access: Guest (as per default install)
    * Registered, id=2, User Groups Having Viewing Access: Registered (as per default install)
    * Player, id=7, User Groups Having Viewing Access: Captain, Co-Captain, Guest, President, Publisher, Secretary, Treasurer, Vice-President, Webadmin, Webmaster
    * Captain, id=8, User Groups Having Viewing Access: Captain, Co-Captain, President, Secretary, Treasurer, Vice-President, Webadmin, Webmaster
    * Publisher, id=9, User Groups Having Viewing Access: President, Publisher, Secretary, Treasurer, Vice-President, Webadmin, Webmaster
    * Administrator, id=10, User Groups Having Viewing Access: President, Secretary, Treasurer, Vice-President, Webadmin, Webmaster
    * Webadmin, id=11, User Groups Having Viewing Access: Webadmin, Webmaster
    * Webmaster, id=12, User Groups Having Viewing Access: Webmaster

===== Extensions =====
  - Create "Contact Us" contact with id=1 in core component //Contacts// in the back-end.
  - Download and install [[https://www.akeebabackup.com/products/akeeba-backup.html|Akeeba Backup]]. Run the //Configuration Wizard//. Modify zip format and output file directory. [[https://www.akeebabackup.com/documentation/troubleshooter/post-restoration.html|Troubleshooter]]
  - Download and install [[https://www.phoca.cz/phocadownload|Phoca Download]]. Give Operators access permissions through //Options// in the back-end.

===== Bethico =====

==== Template =====
  - Install template **Bethicoleague**
  - Make the template default and change the module positions in the backend
  - Copy empty index.php to folder /administrator/templates/bethicoleague/ as work-around for bug in J3.9.18

==== Module Bethico Language Switcher =====
  - Install **mod_bethico_switcher**
  - Assign module position and enable for all pages
  - Note that flags will show only after the com_bethico has been installed

==== Module Bethico Cookies =====
  - Install **mod_bethico_cookies**
  - Install **plg_system_bethico**
  - Set cookie name to "bethico_cookies_[league]"

==== Module on position right (sidebar) =====
  - Create article with content "{loadposition right}" to view sidebar on mobile devices
  - All modules on position right need to have a Module Class Suffix of " sidebar"

==== Menus ====
  - Create menus with title 'Main Menu' and 'Member Menu'. Main Menu is already created when installing the framework, the titles for the menus are required for the template to work.

==== Administrator plugin ====
  - Install **bethicoadmin** plugin
  - add //return;// to 'joomlaupdate' and 'extensionupdate' plugins to avoid their quickicons to load in the Control Panel
  - add 'icon' => 'header/icon-48-purge.png' to 'akeebabackup' plugin to enable icon in Control Panel

==== Administrator logo ====
  - Install all league logo files into /images/bethico
  - Set "logo-menu-small.png" as logo
  - Set "logo-menu-login.png" as login logo