Watch the screencast

Text Version

Step 1 – Adding the attachments

Adding attachments with the proper name is fundamental for this technique. We will append the language ISOs to the names, so that they can later be targeted in the template.

Login to the back office, then navigate to Catalog > Products, and choose one to start with. At the bottom of the Options tab, add two test attachments. The file names don’t matter, but the title you choose does. Add one attachment for each language it’s translated to, making sure you append the ISO code for that language after the name, like this: _en, _it, _fr.

Note: If you don’t know what the language code is, hop to International > Localization, and click on Languages. The ISO code is listed in the table:

If you need an attachment to display for all of the languages, make sure you do not add any language ISO to it.

Step 2 – Editing the template

For this tutorial I am using the “classic” template, that ships with PrestaShop 1.7. If you are using a custom theme, be aware that some of the code might be different, or even located in a different file.

Open up themes/classic/templates/catalog/product.tpl.

Locate the following code:

{if $product.attachments}
                    <div class="tab-pane fade in" id="attachments" role="tabpanel">
                       <section class="product-attachments">
                         <h3 class="h5 text-uppercase">{l s='Download' d='Shop.Theme.Actions'}</h3>

Right afterwards, but before the foreach loop, add the following

{$lang_checker = "_"|cat: {$language.iso_code}}
{$lang_checker_array = ['en', 'it']}

Make sure you use your own ISO codes instead of ‘en’ and ‘it’. Add all of the languages your store supports

Next, wrap the attachment block in the following IF statement

                         {if $attachment.name|strstr:{$lang_checker}}
                           <div class="attachment">
                             <h4><a href="{url entity='attachment' params=['id_attachment' => $attachment.id_attachment]}">{$attachment.name|replace:{$lang_checker}:''}</a></h4>
                             <p>{$attachment.description}</p
                             <a href="{url entity='attachment' params=['id_attachment' => $attachment.id_attachment]}">
                               {l s='Download' d='Shop.Theme.Actions'} ({$attachment.file_size_formatted})
                             </a>
                           </div>
{/if}

If you don’t need some attachments to display for all languages, you can go ahead and test it, as the basic part if basically done. If you do, you will need to add a little extra condition, and we will use that lang_checker_array for it.

Step 2.1 – Fallback for generic attachments

Right before the end of the IF statement that checks for our ISO code, add the following:

{else}
  {$denier = false}
  {foreach from=$lang_checker_array item=checkr_lang}
                              {if $attachment.name|strstr:{$checkr_lang}}
                              {$denier = true}
                              {/if}
  {/foreach}

Explanation: We are setting a variable (denier) that will prevent displaying the attachment if it contains any language ISO. Because of this logic, make sure you use a string that’s unique enough in case your attachment names contain product codes or alike, otherwise they won’t ever display.

Right afterwards, but still inside our main IF, add this last chunk of code

                               
{if !$denier}
<div class="attachment">
<h4><a href="{url entity='attachment' params=['id_attachment' => $attachment.id_attachment]}">{$attachment.name|replace:{$lang_checker}:''}</a></h4>
<p>{$attachment.description}</p
<a href="{url entity='attachment' params=['id_attachment' => $attachment.id_attachment]}">
{l s='Download' d='Shop.Theme.Actions'} ({$attachment.file_size_formatted})
</a>
</div>
{/if}

Which is basically a copy of the standard attachment code. If the attachment does not contain any iso code, it means we can display it normally.

We are done!

The post Creating Multilanguage attachments in PrestaShop 1.7 appeared first on NemoPS.

• Version compatibility: Prestashop 1.4, Prestashop 1.5

Introduction

So, you have a multilanguage store. And you also offer detailed spreadsheets of your products, or bonus videos, as downloadable attachments in product pages. There is a problem though: Prestashop doesn’t come with a way of targeting specific languages when adding attachments (even though the attachment name is translatable). How to cope with it, in case your attachments are really language-specific? With a little trick, we will take advantage of the default variables assigned to a product page and only display specific downloadable files.

Step 1 – Adding attachments

The first, and most important step is, of course, to add attachments to your products. I will use a demo product, the iPod Nano that comes out of the box with Prestashop. I will also make use of Prestashop 1.5 for this, even though the process can be applied in the same way with 1.4.

Fire up your admin panel and go to Catalog > Attachments (last link). Click on Add new in the top right corner

Here is the little secret: we will append the iso code for our language to the name of the attachment, so that it can be then targeted in the template. Let’s call our file demo_en. Don’t worry for the bad look it has, we will remove the useless part when displaying links. Add a description if you want (it’s not mandatory), and choose a file to upload. When you’re done, click Save. Note that the actual name of the file doesn’t matter at all, the important part is the attachment name. If you don’t know the iso code for your language, head over to Localization > Languages, and check the column highlighted in the following image:

Prestashop Languages Tab

Step 2 – Attaching our file to the product

Ok, we have our file, it’s time to add it to one of our products. Head over to a product page in the back office (I chose iPod Nano), and click on the Attachments tab in the left column. Here is what it’ll look like:

Prestashop Product Attachments

Step 3 – Adding the language-specific logic

Now that the attachment has been sticked to our product, let’s head for the front office and check it out. Here it is:

Prestashop Attachments in product page

Of course, it will be displayed for every language at this stage. Locate your theme folder, and open up product.tpl in your favorite code editor. We will be editing the attachments portion of this file to only display our languaged file.

Locate the following code (Prestashop 1.5.3 – at about line 518):

		{if isset($attachments) && $attachments}

If you’re on Prestashop 1.4, it will be more like this (default template)

		{if $attachments}

You will have the following block inside the condition:

	<ul id="idTab9" class="bullet">
	{foreach from=$attachments item=attachment}
		<li><a href="{$link->getPageLink('attachment', true, NULL, "id_attachment={$attachment.id_attachment}")}">{$attachment.name|escape:'htmlall':'UTF-8'}</a><br />{$attachment.description|escape:'htmlall':'UTF-8'}</li>
	{/foreach}
	</ul>	

Let’s start amending it to add some language logic, add this just after the div’s opening:

	{$lang_checker = {"_"|cat:{$lang_iso}}}
	{foreach from=$languages item=language} 
		{$lang_checker_array[] = {"_"|cat:{$language.iso_code}}}
	{/foreach}	

Explanation: We are taking advantage of 2 variables here. First, we create a $lang_checker variable, consisting of an underscore plus the iso code of the current language of the store (this will help us target it in the attachment name); then, we create an array with all the languages’ iso codes, and as before, they’re prepended of an underscore. You can actually use any special character here, but you’ll of course need to be consitent with attachment names if you want to do it.

Now, amend the foreach statement as follows:

{foreach from=$attachments item=attachment}
	{if $attachment.name|strstr:{$lang_checker}}
			<li><a href="{$link->getPageLink('attachment', true, NULL, "id_attachment={$attachment.id_attachment}")}">{$attachment.name|escape:'htmlall':'UTF-8'|replace:{$lang_checker}:''}</a><br />{$attachment.description|escape:'htmlall':'UTF-8'}</li>			
	{/if}
{/foreach}	

Refresh the page. You won’t see changes if your current language is the same as the attachment’s one, otherwise, you’ll notice the attachment is gone! Yep, that’s it, we are only displaying the attchment if it contains the actual iso code. We are also replacing (|replace:{$lang_checker}:”) the iso so that it’s removed from the name. Sweet.

Note: on Prestashop 1.4, the getPageLink must refer to attachment.php, not only attachment.

And we could stop here, careless of future implementation. But we are smart. The code needs to be more robust in case we change our mind and want to display some attachments to all the audience. At the moment, those ones would not be displayed due to our language restriction.

Step 4 – Fallback for non-languaged downloads

Add another attachment to this product, but this time don’t append any iso code. If you refresh the product page, you won’t be able to see the new attachment, of course. Let’s amend our previous code the following way:

{if isset($attachments) && $attachments}
	

	{$lang_checker = {"_"|cat:{$lang_iso}}}
	{foreach from=$languages item=language} 
		{$lang_checker_array[] = {"_"|cat:{$language.iso_code}}}
	{/foreach}			
	{foreach from=$attachments item=attachment}
		{if $attachment.name|strstr:{$lang_checker}}
				
{$attachment.name|escape:'htmlall':'UTF-8'|replace:{$lang_checker}:''}
{$attachment.description|escape:'htmlall':'UTF-8'}
	
		{else}	
			{$denier = false}
			{foreach from=$lang_checker_array item=checkr_lang}
				{if $attachment.name|strstr:{$checkr_lang}} 
					{$denier = true}
				{/if}		
			{/foreach}
			{if !$denier}
				
{$attachment.name|escape:'htmlall':'UTF-8'}
{$attachment.description|escape:'htmlall':'UTF-8'}
			{/if}									
		{/if}
	{/foreach}
	
{/if}	

Explanation: A bit messy, but don’t be afraid. We added an else condition in case the iso code pattern is not found in the name. Inside it, we first setup a variable to check whether the file name contains any of the store languages’ iso codes. Remember we created an array with all the store languages before? it’s time to use it; the following iterates through it, and, if one of the languages matches, it sets $denier to true.

	{$denier = false}
	{foreach from=$lang_checker_array item=checkr_lang}
		{if $attachment.name|strstr:{$checkr_lang}} 
			{$denier = true}
		{/if}		
	{/foreach}

So basically we’re tellng the Prestashop: “If the file is setup to target a specific language, set $denier to true.”. The next line shows how to make proficient use of our $denier variable:

		{if !$denier}
			
{$attachment.name|escape:'htmlall':'UTF-8'}
{$attachment.description|escape:'htmlall':'UTF-8'}
		{/if}	

If $denier is not set (read: if this file is not configured to target a specific language) add it to the list. Save&Refresh.

The non-language file is now added to the list!

Conclusion

And that’s it, you can now play around with different iso codes and see they will always show up the correct way. Of course, there are better way to implement such feature, like editing core files to make it seamless with Prestashop. Nonetheless, this is a cleaver way to achieve the result without heavy core modifications.

The post Target specific languages with Prestashop Attachments appeared first on NemoPS.