====== 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 German. 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 both, [[https://docs.joomla.org/J3.x:Google_ReCaptcha#For_Contact_forms_and_the_Registration_form|Google ReCaptcha]] and [[https://www.google.com/recaptcha|Invisible ReCaptcha]]

===== Extensions =====
  - Install [[https://www.akeebabackup.com/products/akeeba-backup.html|Akeeba Backup]] version 7.1.3 or higher
    * Run the //Configuration Wizard//
    * Modify zip format and output file directory
    * [[https://www.akeebabackup.com/documentation/troubleshooter/post-restoration.html|Troubleshooter]]
  - Install [[https://www.joomshaper.com/page-builder|SP Page Builder Pro]] version 3.7.1 or higher
  - Install [[https://www.unitecms.net/joomla-extensions/unite-revolution-slider-responsive|Unite Slider]] version 5.0.16 or higher
    * You need to manually modify image path in //#__revslider_slides// after changing server or site url (for example when copying a backup from your development environment)
  - Install [[https://vinagecko.com/joomla-modules/item/78-article-accordion|Vina Article Accordion]] version 2.0 or higher
    * Set colors in back-end module settings
    * Modify open/close images in /modules/mod_vina_accordion_content/assets/images if necessary
    * Add rounded corners styling to /modules/mod_vina_accordion_content/assets/css/style.css
    * Fix rounded corners javascript code in /modules/mod_vina_accordion_content/assets/js/jquery.accordion.js<code>// $(this).addClass(opts.cssClose).removeClass(opts.cssOpen);
// bco: fix rounded borders during closing
setTimeout(function(ths, opts){$(ths).addClass(opts.cssClose).removeClass(opts.cssOpen);}, 560, this, opts);</code>
  - Install [[https://joomdonation.com/joomla-extensions/eshop-joomla-shopping-cart.html|EShop]] version 3.3.0 or higher
    * Change Twitter Bootstrap Version to 4 in //System --> Layout//, but do not load the bootstrap CSS from EShop
    * Remove file /components/com_eshop/themes/default/css/custom.css as it's empty
    * Remove unneeded image files from /media/com_eshop
    * Modify styles in your templates custom.css
    * Copy eshop modules css from /modules/mod_eshop_<mod>/asset/style.css to /templates/bethico/css/mod_eshop_<mod>.css and modify, for example mod_eshop_cart.css
    * Replace the last line of /modules/mod_eshop_cart/mod_eshop_cart.php with:<code>if ($countProducts) require JModuleHelper::getLayoutPath('mod_eshop_cart', $params->get('layout', 'default'));</code>
  - Install [[https://www.joomshaper.com/joomla-extensions/sp-simple-portfolio|SP Simple Portfolio]] component & module version 1.8. Version 1.9 is buggy and does not work.
    * Copy files in /template/bethico/overrides/mod_spsimpleportfolio
    * Must use the template override
  - Install [[https://github.com/joomdev/JD-Simple-Contact-Form|JD Simple Contact Form]] module version 1.6 or higher
    * Copy files in /template/bethico/overrides/mod_jdsimplecontactform
    * Must use the template override

===== Bethico =====

==== Template =====
  - Install template **Bethico**. This is based on Helix Ultimate which uses Bootstrap v4.1.0! Header style-3 and custom.css have been modified from the original Helix Ultimate template.
  - Make the template default and change the module positions in the backend

==== Images ====
  * Copy all folders in /images

==== Menus ====
  * Main Menu: disable menu text, assign icons
    - {{fa>home?fw}} Home (fa-home)
    - {{fa>blog?fw}} Blog (fa-blog)
    - {{fa>trophy?fw}} Leagues (fa-trophy)
    - {{fa>coins?fw}} Functions and Statistics (fa-coins)
    - {{fa>tools?fw}} Create a site (fa-tools)
    - {{fa>question?fw}} FAQ (fa-question)
    - {{fa>file-alt?fw}} Bethico Wiki (fa-file-alt)
    - {{fa>shopping-cart?fw}} Shop (fa-shopping-cart)

==== Bethico Captcha: plg_bethico_captcha ====
  - Install **plg_bethico_captcha**
  - Enable plugin and check settings
  - Set //Blacklist file// if you want the plugin to register IPs of detected bots. Currently, a bot is detected if a form field is filled, one which is hiddent to humans. The //Blacklist file// path is relative to the document root of the Joomla installation the plugin is activated for. Add something like '../../ipblacklist.conf' to have the file written to a path outside of the document root. This way, the file can be shared by all instances the plugin is active in. Make sure the folder where ipblacklist.conf resides in is writeable for the apache user. IPs are not recorded if the file path is empty.
  - Set //Server restart command// to the command used to reload config or restart the server for the newly blocked IP to be recognized. On a debian system this would be '/etc/init.d/apache2 reload' which needs to be executed as root, so enter 'sudo /etc/init.d/apache2 reload' here. You also need to make sure that the apache user is allowed to run the command without password in the sudoers file. You may leave the command empty to avoid executing any command after a bot IP has been detected.

==== Bethico Language Switcher: mod_bethico_switcher =====
  - Install **mod_bethico_switcher**
  - Assign module position and enable for all pages
  - Copy folder "flags24" to /media/com_bethico/images/

==== Bethico League Info: mod_bethico_league_info =====
  - Install **mod_bethico_league_info**
  - Make sure the module helper can access all databases of all leagues
  - Make sure file ''/components/com_bethico/sitename.php'' exists for all leagues

==== Bethico Legal: mod_bethico_legal =====
  - Install **mod_bethico_legal**
  - Assign module position and enable for all pages

==== Bethico Cookies: mod_bethico_cookies =====
  - Install **mod_bethico_cookies**
  - Assign module position and enable for all pages
  - Copy folder "js" to /media/com_bethico
  - Based on [[https://www.extnbakers.com|EB Sticky Cookie Notice]]

==== Administrator plugin: plg_bethicoadmin ====
  - Install **bethicoadmin** plugin
  - add //return;// to 'quickicon/joomlaupdate' and 'quickicon/extensionupdate' plugins to avoid their quickicons to load in the Control Panel
  - add 'icon' => 'header/icon-48-purge.png' to 'quickicon/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