= Audina Website v4 (Joomla 3.1) =

== Configuration ==
  * Upgrade the Ubuntu Linux server (if using 13.10 or up): <code>sudo apt-get install apache2 php5-mysql libapache2-mod-php5 mysql-server php5-json phpmyadmin php5-curl unzip</code>
  * Unpack ZIP file to a folder under ''/var/www'' on the web server (such us ''en'' for English, or ''es'' for Spanish). Eg: <code bash>
% mkdir /var/www/en
% cp audina-v4.tar.gz /var/www/en
% cd /var/www/en
% tar xzf audina-v4.tar.gz 
</code>
  * Create database in MySQL: <code sql>
mysql> CREATE DATABASE `audina_joomla30_en`; 
mysql> CREATE USER 'joomlausr'@'localhost' IDENTIFIED BY  '***';
GRANT ALL PRIVILEGES ON * . * TO  'joomlausr'@'localhost' IDENTIFIED BY  '***' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;
GRANT ALL PRIVILEGES ON  `audina_joomla30_en` . * TO  'joomlausr'@'localhost';
</code>
  * Import data from SQL script into database. Eg:  <code sql>
mysql> SOURCE audinadata.sql
</code>
  * Edit file ''//site///configuration.php''. Eg: <code php>
<?php
<?php
class JConfig {
	public $offline = '0';
	public $offline_message = 'This site is down for maintenance.<br /> Please check back again soon.';
	public $display_offline_message = '1';
	public $offline_image = '';
	public $sitename = 'Audina Hearing Instruments, Inc.';
	public $editor = 'tinymce';
	public $captcha = '0';
	public $list_limit = '20';
	public $access = '1';
	public $debug = '0';
	public $debug_lang = '0';
	public $dbtype = 'mysql';
	public $host = 'localhost';
	public $user = 'joomlausr';
	public $password = 'joomlapass';
	public $db = 'audina_joomla30_en';
	public $dbprefix = 'jos3_';
	public $live_site = '';
	public $secret = 'WYI0rBV4EGKydj2I';
	public $gzip = '0';
	public $error_reporting = 'default';
	public $helpurl = 'http://help.joomla.org/proxy/index.php?option=com_help&keyref=Help{major}{minor}:{keyref}';
	public $ftp_host = '';
	public $ftp_port = '';
	public $ftp_user = '';
	public $ftp_pass = '';
	public $ftp_root = '';
	public $ftp_enable = '0';
	public $offset = 'America/New_York';
	public $mailer = 'mail';
	public $mailfrom = 'info@audina.net';
	public $fromname = 'Audina Hearing Instruments, Inc.';
	public $sendmail = '/usr/sbin/sendmail';
	public $smtpauth = '0';
	public $smtpuser = '';
	public $smtppass = '';
	public $smtphost = 'localhost';
	public $smtpsecure = 'none';
	public $smtpport = '25';
	public $caching = '0';
	public $cache_handler = 'file';
	public $cachetime = '15';
	public $MetaDesc = 'Audina manufactures innovative custom and stock hearing aids for all ranges of hearing loss, offering quality and affordable options.';
	public $MetaKeys = 'Audina, Hearing Instruments, Hearing Aids, Custom, BTE, OTE, RIC, Behind-The-Ear, Over-The-Ear, Receiver-In-Canal';
	public $MetaTitle = '1';
	public $MetaAuthor = '0';
	public $MetaVersion = '0';
	public $robots = '';
	public $sef = '1';
	public $sef_rewrite = '1';
	public $sef_suffix = '0';
	public $unicodeslugs = '0';
	public $feed_limit = '10';
	public $log_path = '/var/www/en-v4/logs';
	public $tmp_path = '/var/www/en-v4/tmp';
	public $lifetime = '15';
	public $session_handler = 'database';
	public $MetaRights = '';
	public $sitename_pagetitles = '1';
	public $force_ssl = '0';
	public $feed_email = 'author';
	public $cookie_domain = '';
	public $cookie_path = '';
}
?>
</code>
  
  * Point the browser to website URL, and test.
== Search Engine Optimization ==
  * Home page Title should have keywords.
  * Description Metatag should have relevant site summary for Google to display it.
  * Images in Home page should have descriptive ''alt'' descriptions.
  * Switch on Search Engine Friendly URLs (Global Configuration).
  * Switch on Apache mod_rewrite (Global Configuration).
=== Apache mod_rewrite Setup ===
  * Install mod_rewrite support for apache.
    * Enable it: <code bash>% sudo a2enmod rewrite</code> or <code bash>% cd /etc/apache2/mods-enabled
% ln -s ../mods-available/rewrite.load rewrite.load</code>
    * Enable AllowOverride for apache: Edit file ''/etc/apache2/sites-available/default'' (or whatever the virtual site is using) and set it to ''AllowOverride All''. Eg:<code bash><Directory /var/www/>
    Options Indexes FollowSymLinks MultiViews
    #AllowOverride None
    AllowOverride All
    # Apache 2.2
    #Order allow,deny
    #allow from all
    # Apache 2.4
    Require all granted
    # Uncomment this directive is you want to see apache2's
    # default start page (in /apache2-default) when you go to /
    #RedirectMatch ^/$ /apache2-default/
</Directory></code>
    * Restart apache: <code bash>% /etc/init.d/apache2 restart</code>
  * Create test script. Sample test ''.htaccess'' file:<code bash>
RewriteEngine On
Options +FollowSymLinks
RewriteRule ^joomla\.html http://www.joomla.org/? [R=301,L]
RewriteRule ^link([^/]*).html$ rewrite.php?link=$1 [L]
</code>Test script ''rewrite.php'' (open in browser, and test links being displayed):<code php>
<html>
<body>
<h2>
<?php
if($_GET['link']==1)
{
  echo"You are NOT using mod_rewrite";
}
elseif($_GET['link']==2)
{
  echo"Congratulations!! You are using Apache mod_rewrite";
}
else
{
  echo"Apache mod_rewrite Test Tutorial";
}
?>
</h2>

<p><a href="rewrite.php?link=1">LINK1</a> = rewrite.php?link=1</p>
<p><a href="link2.html">LINK2</a> = link2.html</p>
<p>How this works: both links are for this same page, but each calls the page differently:</p>
<ul>
<li>Link1 is without the mod_rewrite. It shows the php file.</li> 
<li>Link2 is using mod_rewrite. </li>
</ul>
<p>
With mod_rewrite, we are mascarading the php file into an html file. Any extension can be used (eg: .htm, .shtml etc.). Make sure it is reflected in the .htaccess file</p>
</body>
</html>

</code>
  * Rename and test Joomla's ''htaccess.txt'' to ''.htaccess''
= Language Switching =
== Dropdown Selector ==

<code html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-gb" lang="en-gb" >
<head>
. . .
<script language="JavaScript" type="text/JavaScript">
<!--
function MM_jumpMenu(targ,selObj,restore){ //v3.0
  eval(targ+".location='"+selObj.options[selObj.selectedIndex].value+"'");
  if (restore) selObj.selectedIndex=0;
}
//-->
</script>

</head>

<body>
. . .
<form name="formLangSelection" id="search">
    Language 
    <select name="menuLangSelection" id="menuLangSelection" onChange="MM_jumpMenu('parent',this,0)">
        <option value="../en" selected>English</option>
        <option value="../es">Espa&ntilde;ol</option>
    </select>
</form>
</body>

</code>

== Google Translate Dropdown Selector ==
<code html>
<html>
<head>
</head>
<body>
			<div class="moduletable">
					<noscript>Javascript is required to use this <a href="http://edo.webmaster.am/gtranslate">website translator</a>, <a href="http://edo.webmaster.am/gtranslate">free translator</a></noscript>

<script type="text/javascript">
//<![CDATA[
                    if(top.location!=self.location)top.location=self.location;
        window['_tipoff']=function(){};window['_tipon']=function(a){};
        function doTranslate(lang_pair) {if(lang_pair.value)lang_pair=lang_pair.value;if(lang_pair=='')return;if(location.hostname=='www.audina.net' && lang_pair=='en|en')return;var lang=lang_pair.split('|')[1];if(location.hostname!='www.audina.net' && lang_pair=='en|en')location.href=unescape(gfg('u'));else if(location.hostname=='www.audina.net' && lang_pair!='en|en')location.href='http://translate.google.com/translate?client=tmpg&hl=en&langpair='+lang_pair+'&u='+escape(location.href);else location.href='http://translate.google.com/translate?client=tmpg&hl=en&langpair='+lang_pair+'&u='+unescape(gfg('u'));}
        function gfg(name) {name=name.replace(/[\[]/,"\\\[").replace(/[\]]/,"\\\]");var regexS="[\\?&]"+name+"=([^&#]*)";var regex=new RegExp(regexS);var results=regex.exec(location.href);if(results==null)return '';return results[1];}
            //]]>
</script>

<div id="google_translate_element"></div>
<script type="text/javascript">
function googleTranslateElementInit() {
  new google.translate.TranslateElement({
    pageLanguage: 'en',
    includedLanguages: 'en,fr,de,it,ja,ko,pt,ru,es,'
  }, 'google_translate_element');
}
</script>
<script type="text/javascript" src="http://translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
		</div>
	
	</div> 
</div>
</body>
</html>
</code>

= Contact Us Email =

With Joomla 3.x install, the 'Contact Us' page does not send email in some instances.  To fix this, perform the following steps:
  * In Administration backend, go to System --> Global --> Contacts.
  * Select Form tab, and turn off the following:
    * Session Check
    * Session Reply
  * Save, and test 'Contact Us' form.

= Content Editing =
== Footer ==
 * Edit file ''<//joomla_root//>/templates/audina2013/html/mod_footer/custom.php''

== Carousel Images == 
   * Edit 'Home' article as HTML. Go to Joomla > Content > Article > Featured Articles.  Each article should have a reference to an image (eg: ''slide-1.jpg'') in the introduction section.
   * Place slider images in ''<//joomla_root//>/images/slider''. Eg: ''images/slider/slide-1.jpg''

== News Articles ==
   * Edit any article (or add a new one). Go to Joomla > Content > Article Manager, then filter Category as ''Latest''.
   * When adding an article:
     * Choose Section ''News'', and Category ''Latest'' for that article.
     * Place content within paragraph tags. Eg ''<p> xxx </p>''

== Workshops and Conventions ==
   * Edit article calendar wrapper listing workshops and conventions. 
     * Go to Joomla > Content > Article Manager, then filter Section as ''Professionals''. 
     * Edit article 'Calendar Wrapper'.
   * Edit Calendar component. 
     * Go to Joomla > Components > CP Event Calendar.
     * For calendar 'Events', click on 'Admin Data' to edit calendar and to add/delete events.

== Forms (using ChronoForms) ==
   * Components > Chrono Forms > Forms Manager.
   * Update email addresses on forms: 
     * Select form under 'Wizard Edit' column.
     * Select Actions tab (left).
     * Select under 'Events' tab (right) if available: 
       * OnSuccess > Email - To User > Configure (button right side) > Static (tab).
       * OnSuccess > Email - To SysAdmin > Configure (button right side) > Static (tab).
     * Select under 'Emails' tab (right) if available:
       * Edit To/From email addresses.

= Backup Files =
  * A copy of the webserver files can be found in ''/data/backup/www''