# Plugin: SobiPro

## Description <a href="#description" id="description"></a>

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

You can also use this plugin to automatically include your newly created (or modified) SobiPro items in an Auto-newsletter or a Newsletter.

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

You can download the SobiPro plugin on our [plugin section](https://www.acyba.com/download/plugins-modules.html) then install and publish it like a standard Joomla plugin.

## Plugin <a href="#plugin" id="plugin"></a>

### Single Item <a href="#single-item" id="single-item"></a>

![](/files/-MJgN_gk7RZ2K_4uV0Ab)

You can use this interface to insert any SobiPro item 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 SobiPro category view
  * **Details View**: the element will be inserted using the SobiPro 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.

### Categories <a href="#categories" id="categories"></a>

![](/files/-MJgNbbnqXwA264_04EN)

You can select one or several SobiPro categories and AcyMailing will automatically include the SobiPro items belonging to the selected categories.

* **Maximum Number of Articles**: The inserted tag will be replaced by a maximum of X SobiPro items.
* **Minimum Number of Articles**: This option will only be displayed if you access this plugin for a Smart-Newsletter. AcyMailing will only generate your Smart-Newsletter if the minimum number of SobiPro items found is reached.
* **Filter**: This option will only be displayed if you access this plugin for a Smart-Newsletter. You can set a rule so that only newly created or modified SobiPro items are added to your Newsletter.

## Parameters <a href="#parameters" id="parameters"></a>

![](/files/-MJgNdgCKckhyKqGlZYu)

Sobi Params

* **Display articles**: This parameter enables you to filter the list of SobiPro items in the tag system
  * **All articles**: AcyMailing will display all your SobiPro items
  * **Only published articles**: AcyMailing will only display your published SobiPro items
* **Remove javascript**: This option enables you to remove any javascript code included in your SobiPro 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.

## Customize your SobiPro item template <a href="#customize-your-sobipro-item-template" id="customize-your-sobipro-item-template"></a>

### Customize your item using some CSS <a href="#customize-your-item-using-some-css" id="customize-your-item-using-some-css"></a>

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

Edit the AcyMailing template used for your Newsletter and then set some styles:

> * **Style for the content area** will be used to encompass your Sobi item
> * **Style for the content title** will be applied to your content title
> * **Style for the read more link** will be applied to your read more link (if you have one)
> * You can also set the style of all your links using the **Link a** field

![](/files/-MJgNfVLlw7CaXA-q6eE)

Set styles template

### Create your own template <a href="#create-your-own-template" id="create-your-own-template"></a>

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

Create a file in the folder **media / com\_acymailing / plugins** (if the folder does not exists, please create it first). The name of the file should be **sobipro.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 the element $article (which is the article object loaded from the content table) and the element $tag (which contains the information of the current tag used in your Newsletter).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acymailing.com/old/integration-plugins/content-management/plugin-sobipro.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.