Plugin: PhocaDownload


This plugin enables you to insert files link (one by one or by a selection on one or several categories) from PhocaDownload in your Newsletter.

You can also use this plugin to automatically include your new files in an Auto-newsletter or a Newsletter.

You can search in all your files and then click on one of the items to include it in your Newsletter.

You can download this plugin from our download area if you purchased at least one of our commercial version.


Single file

You can use this interface to insert any files in your Newsletter. Each item can be selected one by one.

  • Display:

    • Title Only: only the title will be inserted

    • Category View: the element will be inserted using the PhocaDownload category view

    • Details View: the element will be inserted using the PhocaDownload details view

  • Display pictures: You can decide to display or not this picture in your Newsletter or display a resized size of it.

  • Clickable Title: make your title clickable (so linked to your online version) or not.

  • Download: Create a direct link to the file so you can download it from the Acymailing newsletters.


You can select one or several categories and AcyMailing will automatically include the new files from the selected categories when their starting date is inferior to the maximum starting date you specified.

  • Maximum Number of Articles: The inserted tag will be replaced by a maximum of X file.

  • Maximum Starting Date: AcyMailing will only include file when their starting date is less than X days after the current time. You can define this delay using this parameter.

  • Minimum Number of Articles: This option will only be displayed if you access this plugin for a Smart-Newsletter. AcyMailing will only generates your Smart-Newsletter if the minimum number of file found is reached.


  • Intro Word Wrapping : If you insert only the introduction, AcyMailing will insert all the text before the "read more" link. But if you didn't insert the read more link in your PhocaDownload Content, AcyMailing will only load the first XX characters of your content. If you specify 0 and you didn't add the "read more" link, AcyMailing won't wrap your content and load the entire article.

  • Display articles: This parameter enables you to filter the list of PhocaDownload items in the tag system

    • All articles: AcyMailing will display all your PhocaDownload items

    • Only published articles: AcyMailing will only display your published PhocaDownload items

  • Remove javascript: This option enables you to remove any javascript code included in your PhocaDownload item as the javascript won't work in most of mail clients.

  • Max picture height / Max picture width : In case of you selected the resized option, AcyMailing will resize your pictures following the specified max height / width.

  • Menu ID : ID of the menu attached to the PhocaDownload Component..

Customize your PhocaDownloads template

You can change the styles used for the files title and the items area by editing the styles in your AcyMailing template.

You can also modify the way your file is displayed by creating your own template which will be used to render the file. Please follow those instructions, we don't recommend you to modify the PhocaDownload plugin directly otherwise your changes will be overwritten when you update AcyMailing.

Create a file in the the folder media / com_acymailing / plugins (if the folder does not exists, please create it first). The name of the file should be phocadownload.php If this file is available on your server, AcyMailing will use it and won't use the default one.

On this file you can access to the element $article (which is the item object loaded from the PhocaDownload table).

You can display:

  • the Id of the file : $article->fileId

  • the name of the file : $article->file_title

  • picture of the article: $article ->thumbnail

  • File creator: $article ->username

  • Published date: $article ->date

  • the url of your item: $link

Using all those variables, you can create your own product template.

Last updated