> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/norrcompetition/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/norrcompetition/plugins/application-for-easysocial.md).

# Application for EasySocial

Integration between NorrCompetition and EasySocial community platform.

Product page: [NorrCompetition Application for EasySocial](https://norrnext.com/joomla-extensions/norrcompetition-addons-pack#easysocial)

This add-on provides bidirectional integration between NorrCompetition and the EasySocial community platform:

* **EasySocial Application**: Embeds participant contest entries, photo submissions, and vote statistics directly into the contestant's EasySocial profile.
* **Activity Stream Plugin (`plg_competition_estream`)**: Posts automated real-time activity events to the EasySocial social timeline whenever users create contests, submit entries, vote, or win Grand Prix awards.

***

### Installation

The integration package contains two extensions:

1. **`easysocial_norrcompetition_x.x.x.zip`** (EasySocial Application): Install via EasySocial: **Components > EasySocial > Applications > Install**.
2. **`plg_competition_estream_x.x.x.zip`** (Activity Stream Plugin): Install as a standard Joomla extension via **System > Install > Extensions**.

After installation, publish the `Competition - Activity Stream` plugin in the Joomla Plugin Manager.

***

### Application Configuration

In the Joomla Administrator panel, navigate to **Components > EasySocial > Applications > NorrCompetition**.

#### 1. Stream Tab

Configure which NorrCompetition user actions generate stream posts in the EasySocial activity timeline:

* **Stream Filter**: Toggle whether NorrCompetition items appear as a dedicated filter in the EasySocial feed.
* **Create Contest**: Post an activity item when a user creates a new contest.
* **Submit Entry**: Post an activity item when a user submits an entry to a contest.
* **Vote**: Post an activity item when a user casts a vote for an entry.
* **Grand Prix**: Post an activity item when an entry is awarded a Grand Prix status by moderators.

#### 2. Profile Tab

Configure how entries are presented within the contestant's EasySocial user profile:

* **Total Entries to Display**: Set the maximum number of submitted entries shown on a user profile (`0` = no limit).
* **Show Photo**: Toggle visibility of entry thumbnail images in the profile view.

***

### Activity Stream Plugin

The **Competition - Activity Stream** plugin (`plg_competition_estream`) triggers stream events according to your application options. On the plugin's **Download Key** tab, enter your NorrNext Download Key to enable automated updates via the Joomla Update System.

***

### CSS Customization

Thumbnails displayed in the EasySocial timeline use the class `.es-stream-content-avatar`. You can adjust image scaling or container dimensions using custom CSS in your template:

```css
.es-stream-content-avatar {
    max-width: 80px;
    border-radius: 4px;
}
```