Audina Website v4 (Joomla 3.1)
Configuration
  • Upgrade the Ubuntu Linux server (if using 13.10 or up):
    sudo apt-get install apache2 php5-mysql libapache2-mod-php5 mysql-server php5-json phpmyadmin php5-curl unzip
  • Unpack ZIP file to a folder under /var/www on the web server (such us en for English, or es for Spanish). Eg:
    % mkdir /var/www/en
    % cp audina-v4.tar.gz /var/www/en
    % cd /var/www/en
    % tar xzf audina-v4.tar.gz 
  • Create database in MySQL:
    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';
  • Import data from SQL script into database. Eg:
    mysql> SOURCE audinadata.sql
  • Edit file site/configuration.php. Eg:
    <?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 = '';
    }
    ?>
  • 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:
      % sudo a2enmod rewrite

      or

      % cd /etc/apache2/mods-enabled
      % ln -s ../mods-available/rewrite.load rewrite.load
    • 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:
      <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>
    • Restart apache:
      % /etc/init.d/apache2 restart
  • Create test script. Sample test .htaccess file:
    RewriteEngine On
    Options +FollowSymLinks
    RewriteRule ^joomla\.html http://www.joomla.org/? [R=301,L]
    RewriteRule ^link([^/]*).html$ rewrite.php?link=$1 [L]

    Test script rewrite.php (open in browser, and test links being displayed):

    <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>
  • Rename and test Joomla's htaccess.txt to .htaccess
Language Switching
<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>
Google Translate Dropdown Selector
<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>
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
  • Edit file <joomla_root>/templates/audina2013/html/mod_footer/custom.php
  • 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