> 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/norrcompetition-application-for-jomsocial.md).

# NorrCompetition Application for JomSocial

Integration between NorrCompetition and JomSocial community platform.

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

This add-on connects NorrCompetition with the JomSocial community extension, providing two components:

1. **JomSocial Application Plugin (`plg_community_norrcompetition`)**: Displays submitted contest entries, votes, and images directly on user profile tabs.
2. **Activity Stream Plugin (`plg_competition_estream`)**: Dispatches activity events to the JomSocial activity stream when users participate in contests.

***

### Installation

Install both plugins using the standard Joomla Extension Manager (**System > Install > Extensions**):

1. **`plg_community_norrcompetition.zip`** (JomSocial Community Application)
2. **`plg_competition_estream.zip`** (Competition Activity Stream plugin)

After installation, ensure both plugins are published in **System > Plugins**.

***

### Application Configuration

Open **System > Plugins** and locate `Community - NorrCompetition`:

| Option                 | Type                | Default        | Description                                                                                                                     |
| ---------------------- | ------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Display Title**      | Text                | *Empty*        | Custom title for the NorrCompetition profile tab/block.                                                                         |
| **Favicon**            | Media               | *Empty*        | Custom icon for the application (recommended: 64×64 PNG).                                                                       |
| **Description**        | Textarea            | *Empty*        | Description displayed under the application header.                                                                             |
| **Count**              | Integer             | `10`           | Number of entries to display in the profile tab.                                                                                |
| **Core Application**   | Switcher (Yes / No) | `No`           | When set to Yes, enables custom position placement.                                                                             |
| **Position**           | Dropdown            | `Main content` | Placement area: *Main content*, *Sidebar Top Tabbed*, *Sidebar Top Stacked*, *Sidebar Bottom Tabbed*, *Sidebar Bottom Stacked*. |
| **Hide if No Content** | Switcher (Yes / No) | `Yes`          | Hides the tab if the user has no submitted entries.                                                                             |

***

### Activity Stream Plugin Configuration

Open **System > Plugins** and locate `Competition - Activity Stream` (`plg_competition_estream`):

* **Create Contest**: Generate a stream event when a user creates a contest.
* **Submit Entry**: Generate a stream event when a user submits an entry to a contest.
* **Vote**: Generate a stream event when a user votes for an entry.
* **Grand Prix**: Generate a stream event when an entry is awarded Grand Prix status.