<h1>Requesting for support</h1>
<p>Things to note when asking for help</p>
<p>Free support service is provided for OpenCart installations with the default theme. Resolving conflicts with other third party extensions/modules, custom theme or any customizations to the extension can be a paid service with negotiable price depending of the difficulties and time to spend.</p>

<h2>Before requesting help</h2>
<ul>
<li>Make sure that the version of the extension is compatible with your OpenCart version.</li>
<li>Check the extension settings page for any error messages and try to fix them if they exist.</li>
<li>If you are using a vQmod version of the extension, please check vqmod folder for a "vqmod.log" file. If the log file exists, try to address the errors that are reported in it.</li>
<li>If you are using a custom theme then you might need to integrate the extension with your custom theme. To do this, check what changes have been done to the default theme and try to make similar adjustments to your custom theme.</li>
</ul>
<h2>Requesting help</h2>
<p>Please describe your problem in as much detail as possible. This will make problem solving much faster.</p>
<p>As a bare minimum, please state the following information when contacting:</p>
<ul>
<li>The OpenCart version you are using.</li>
<li>The extension name, version and type (regular or vQmod) you are having trouble with.</li>
<li>Please describe the installation process in a few details. If you copied some files, please state which files you copied to which location? Did you overwrite any files? If so, which ones? Did you manually edit any files? If so, which ones and what were the changes.</li>
<li>If you got any error messages, please include the error messages in the e-mail.</li>
<li>In case the error message is generated by a vQmod cached file, please also attach that cached file to the e-mail, or better all your vqcache directory zipped.</li>
<li>A screen capture with a short description is also usefull.</li>
</ul>
<p>Any additional information that you can give about the problem is greatly appreciated and will speed up the solving of the issue.</p>
<h2>Translating the extension</h2>
<p>To translate the extension to another language (for example <b>esperanto</b>), do the following to your extension files unzipped:</p>
<ul>
<li>Make a copy of the folder <span style='color:#2a00ff;'>"english"</span> in <span style='color:#2a00ff;'>"upload/admin/language/"</span> (if it exists) and rename it to <span style='color:#e60000;'>"esperanto"</span>.</li>
<li>Open each file inside the freshly created <span style='color:#e60000;'>"esperanto"</span> folder with a text editor (for example Notepad++) and translate the strings to <b>esperanto</b>. <br />
<i>Note !</i> You only need to translate the parts that are to <b>the right</b> of the equal sign.</li>
<li>Make a copy of the folder <span style='color:#2a00ff;'>"english"</span> in <span style='color:#2a00ff;'>"upload/catalog/language/"</span> (if it exists) and rename it to <span style='color:#e60000;'>"esperanto"</span>.</li>
<li>Open each file inside the freshly created <span style='color:#e60000;'>"esperanto"</span> folder with a text editor (for example Notepad++) and translate the strings to <b>esperanto</b>. <br />
<i>Note !</i> You only need to translate the parts that are to <b>the right</b> of the equal sign.</li>
</ul>
<p>If the extension use a VQMod file, do the following:</p>
<ul>
<li>The original english text can be found inside the extension core XML file located in <span style='color:#2a00ff;'>&quot;upload/vqmod/xml/&quot;</span>.</li>
<li>A french translation is provided as a supplementary language XML file. First, <strong>duplicate this file</strong>, and rename it with your suffix language.</li>
<li>Open that new language XML file with a text editor like Notepad++ (not with a word processor application such as MS Word) and search it for language blocks which contain a path like <span style='color:#2a00ff;'>&quot;admin/language/french/&quot;</span> or <span style='color:#2a00ff;'>&quot;catalog/language/french/&quot;</span> such as the following :
  <div style="font-family:monospace;color:#006;border:1px solid #d0d0d0;background-color:#f0f0f0;padding:10px;">
  <pre style='color:#000000;margin:0px;'><span style='color:#7f0055;'>&lt;file</span> name=<span style='color:#2a00ff;'>&quot;admin/language/french/catalog/product.php&quot;</span><span style='color:#7f0055;'>></span>
    <span style='color:#7f0055;'>&lt;operation&gt;</span>
        <span style='color:#7f0055;'>&lt;search</span> position=<span style='color:#2a00ff;'>&quot;after&quot;</span><span style='color:#7f0055;'>></span><span style='color:#3f7f59;'>&lt;![CDATA[</span>
        $_['text_something']
        <span style='color:#3f7f59;'>]]&gt;</span><span style='color:#7f0055;'>&lt;/search&gt;</span>
        <span style='color:#7f0055;'>&lt;add&gt;</span><span style='color:#3f7f59;'>&lt;![CDATA[</span>
$_['text_sample']   = 'Exemple de texte';
        <span style='color:#3f7f59;'>]]&gt;</span><span style='color:#7f0055;'>&lt;/add&gt;</span>
    <span style='color:#7f0055;'>&lt;/operation&gt;</span>
<span style='color:#7f0055;'>&lt;/file&gt;</span>
</pre>
  </div>
</li>
<li>Replace <span style='color:#2a00ff;'>&quot;french&quot;</span> with <span style='color:#e60000;'>&quot;esperanto&quot;</span> in the path and translate the strings to <b>the right</b> of the equal sign. So, with the previous example block you would end up with something similar to this:
  <div style="font-family:monospace;color:#006;border:1px solid #d0d0d0;background-color:#f0f0f0;padding:10px;">
    <pre style='color:#000000;margin:0px;'>
<span style='color:#7f0055;'>&lt;file</span> name=<span style='color:#2a00ff;'>&quot;admin/language/<span style='color:#e60000;'>esperanto</span>/catalog/product.php&quot;</span><span style='color:#7f0055;'>></span>
    <span style='color:#7f0055;'>&lt;operation&gt;</span>
        <span style='color:#7f0055;'>&lt;search</span> position=<span style='color:#2a00ff;'>&quot;after&quot;</span><span style='color:#7f0055;'>></span><span style='color:#3f7f59;'>&lt;![CDATA[</span>
        $_['text_something']
        <span style='color:#3f7f59;'>]]&gt;<span style="color: #7f0055">&lt;/search&gt;</span>
        <span style='color:#7f0055;'>&lt;add&gt;</span><span style='color:#3f7f59;'>&lt;![CDATA[</span>
$_['text_sample']   = '<span style='color:#e60000;'>Specimeno teksto</span>';
        <span style='color:#3f7f59;'>]]&gt;<span style="color: #7f0055">&lt;/add&gt;</span>
    <span style='color:#7f0055;'>&lt;/operation&gt;</span>
<span style='color:#7f0055;'>&lt;/file&gt;</span>
    </pre>
  </div>
</li>

</ul>
<p>When you have finished with the translations, copy your new language XML file to your OpenCart installation and you are done.</p>
