= Audina Website v3 (Joomla 1.5) =

== Configuration ==
  * 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-v3.tar.gz /var/www/en
% cd /var/www/en
% tar xzf audina-v3.tar.gz 
</code>
  * Create database in MySQL: <code sql>
mysql> CREATE DATABASE `audina_joomla15_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_joomla15_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
class JConfig {
        var $offline = '0';
        var $editor = 'jce';
        var $list_limit = '100';
        var $helpurl = 'http://help.joomla.org';
        var $debug = '0';
        var $debug_lang = '0';
        var $sef = '0';
        var $sef_rewrite = '0';
        var $sef_suffix = '0';
        var $feed_limit = '10';
        var $feed_email = 'author';
        var $secret = '7gn9YNTtuVOvbnrs';
        var $gzip = '0';
        var $error_reporting = '-1';
        var $xmlrpc_server = '0';
        var $log_path = '/var/www/audina/en/logs';
        var $tmp_path = '/var/www/audina/en/tmp';
        var $live_site = '';
        var $force_ssl = '0';
        var $offset = '0';
        var $caching = '0';
        var $cachetime = '15';
        var $cache_handler = 'file';
        var $memcache_settings = array();
        var $ftp_enable = '0';
        var $ftp_host = '127.0.0.1';
        var $ftp_port = '21';
        var $ftp_user = '';
        var $ftp_pass = '';
        var $ftp_root = '';
        var $dbtype = 'mysql';
        var $host = 'localhost';
        var $user = 'joomlausr';
        var $db = 'audina_joomla15_en';
        var $dbprefix = 'jos_';
        var $mailer = 'mail';
        var $mailfrom = 'smayr@audina.net';
        var $fromname = 'Audina Website';
        var $sendmail = '/usr/sbin/sendmail';
        var $smtpauth = '0';
        var $smtpsecure = 'none';
        var $smtpport = '25';
        var $smtpuser = '';
        var $smtppass = '';
        var $smtphost = 'localhost';
        var $MetaAuthor = '1';
        var $MetaTitle = '1';
        var $lifetime = '120';
        var $session_handler = 'database';
        var $password = 'somedatabaseuserpassword';
        var $sitename = 'Audina Hearing Instruments';
        var $MetaDesc = 'Audina Hearing Instruments.';
        var $MetaKeys = 'Audina, Hearing Instruments, Hearing Aids, Custom, BTE, OTE, RIC';
        var $offline_message = 'This site is down for maintenance. Please check back again soon.';
}
?>
</code>
  * Setup ''htaccess'' file with some basic security.  This how ''.htaccess'' in the root folder in Joomla should look like:<code bash>
# Deny all PHP pages
<Files *.php>
deny from all
</Files>
# Allow only these PHP pages
<Files ~ "(^index.php|^index2.php|chrono_verification.php)$">
allow from all
</Files>
</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
    Order allow,deny
    allow from all
    # 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>

= Content Editing =
== Carousel Images == 
   * Edit 'Home' article as HTML. Go to Joomla > Content > Article Manager > Home.  
   * Place slider images in ''images/stories/frontpage''. Eg: ''images/stories/frontpage/proslider7.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.
== User Registration (Component) ==
  * Edit file ''<//joomla_root>///components/com_user/views/register/default.php'' to include this at the top:<code php>
<?php // no direct access
defined('_JEXEC') or die('Restricted access');

// coastline wayne code added for forms url
$urlBase =  $this->baseurl;

$mainframe->redirect($urlBase.'/index.php?option=com_chronocontact&chronoformname=Registration');

// end wayne
?>
<script type="text/javascript">
. . .
</code>

== ChronoContact (Component) ==
  * Look for revised ''if'' statement on this plugin called ''$wayneFix'' that cuts off the e-mail from being sent.  See file ''<//joomla_root//>/components/com_chronocontact/plugins/cf_joomla_registration.php''.
= Backup Files =
  * A copy of the webserver files can be found in ''/data/backup/www''