# Membership

### Overview

Memberships in Extension are required to set user group level based on the monthly/Yearly pay plan the user selects. Using membership plans, you can decide how much to charge a user and how many listings a user can make for a particular membership plan.

<div data-hasbody="true" data-macro-name="info" id="bkmrk-membership-are-well-"><div>Membership are well integrated with Joomla groups and have a dependency on each other. Ensure that you have created Joomla groups before creating membership plans. By doing this, you can select groups when creating membership. </div></div>### Create a new Membership Plan

Click Components &gt; Extension &gt; Membership Plans &gt; New to create a new membership plan as shown in the following image:

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/NALobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/NALobraz.png)

**Screen 1: Create new membership plan**

<div data-hasbody="true" data-macro-name="info" id="bkmrk-first-membership-pla"><div>First membership plan should be a Free (basic plan). When user logs into the Front Admin, he will be assigned to that plan. From that point, User can upgrade his membership to paid plans.</div></div>### Edit Membership Plan

If you want to edit existing entries, you can either click the entry from the Membership screen or select the check box next to the entry, and then click **Edit.**

The following image shows the Edit Plan screen.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/IS1obraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/IS1obraz.png)

**Screen 2: Edit Plan screen**

The following table explains the different options seen.

<div id="bkmrk-name-provide-a-name-"><table style="width: 85.5556%; height: 486.4px;"><tbody><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**Name**

</td><td style="width: 74.8911%; height: 35.4px;">Provide a name for the membership plan.

</td></tr><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**Number of Listings**

</td><td style="width: 74.8911%; height: 35.4px;">Provide the number of listings the users in the plan can create.

</td></tr><tr style="height: 52.2px;"><td style="width: 25.1089%; height: 52.2px;">**Group ID**

</td><td style="width: 74.8911%; height: 52.2px;">Select the Joomla user group ID for the plan.

<div data-hasbody="true" data-macro-name="note"><div>It is recommended that you create your membership under the Registered group.</div></div></td></tr><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**Number of Images**

</td><td style="width: 74.8911%; height: 35.4px;">Provide the number of images the users in the plan can add.

</td></tr><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**Price Monthly**

</td><td style="width: 74.8911%; height: 35.4px;">Provide the monthly charge for the plan.

</td></tr><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**Price Annually**

</td><td style="width: 74.8911%; height: 35.4px;">Provide the annual charge for the plan.

</td></tr><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**Best Value**

</td><td style="width: 74.8911%; height: 35.4px;">Best value badge, that shows in Front Admin (informative)

</td></tr><tr style="height: 57.8px;"><td style="width: 25.1089%; height: 57.8px;">**No of Premium Listings**

</td><td style="width: 74.8911%; height: 57.8px;">Provide the number of premium listings the users in the plan can create.

</td></tr><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**Attachments**

</td><td style="width: 74.8911%; height: 35.4px;">Enable to allow users to add attachments to listings.

</td></tr><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**Video**

</td><td style="width: 74.8911%; height: 35.4px;">Enable to allow users to add Video link to the listings.

</td></tr><tr style="height: 57.8px;"><td colspan="1" style="width: 25.1089%; height: 57.8px;">**Custom Fields**</td><td colspan="1" style="width: 74.8911%; height: 57.8px;">Enable custom fields for particular plan.

<div data-hasbody="true" data-macro-name="note"><div>Custom field needs to be assign into **[Paid Groups](https://wiki.comdev.eu/display/JE/Custom+Fields)** to be shown here**.**</div></div></td></tr><tr style="height: 35.4px;"><td style="width: 25.1089%; height: 35.4px;">**ID**

</td><td style="width: 74.8911%; height: 35.4px;">This field is auto generated.

</td></tr></tbody></table>

</div>### Adding paid custom fields to the Membership plans

For adding a custom field to the membership plan, the field group needs to be set to Paid item. Click **Extension** &gt; **Custom Fields**. Click the field you want to add to the membership plan as a paid item. Change the Field Group to **Paid item** for the Item view and Paid items for the Items view as shown in the following image:

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/sEXobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/sEXobraz.png)

**Screen 4: Adding a paid custom field**

This field needs to be enabled in the membership plan as shown in the following image.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/q9aobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/q9aobraz.png)

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">  
</span>

**Screen 5: Enabling the paid custom field**

This field can be seen in the front admin under the membership plan as follows:

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/udRobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/udRobraz.png)

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">  
</span>

**Screen 6: Viewing the paid custom field**

### Membership expiry email configurations

Before the membership expires, an email can be sent to a user that informs them about his membership nearing expiration. The setting can be seen in the following image:

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.comdev.eu/download/attachments/5735029/Membership_Expiry.jpg)</span>

**Screen 3: Configure expiry email field**

### Cron Setting for Membership expiry check

Under your hosting panel a link needs to be added that launches a script. This script checks all users’ membership and sends an email if membership is about to expire:

```bash
curl -sS 'http://yourdomain.com?option=com_jomdirectory&task=expiry.send'
```

<div bis_skin_checked="1" class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" id="bkmrk--6" style="border-width: 1px;"><div bis_skin_checked="1" class="codeContent panelContent pdl"><div bis_skin_checked="1"><div bis_skin_checked="1" class="syntaxhighlighter sh-default nogutter  java" id="bkmrk--7"></div></div></div></div>**<span style="line-height: 1.4285715; background-color: transparent;">or</span>**

```
wget -q -O /dev/null 'http://yourdomain.com?option=com_jomdirectory&task=expiry.send'
```

<div bis_skin_checked="1" class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" id="bkmrk--8" style="border-width: 1px;"><div bis_skin_checked="1" class="codeContent panelContent pdl"><div bis_skin_checked="1"><div bis_skin_checked="1" class="syntaxhighlighter sh-default nogutter  java" id="bkmrk--11"></div></div></div></div>If you are unaware about where the cron setting needs to configured in the hosting panel, contact your hosting support center.

Ensure that the script is launched every day at a particular time consistently.

### Set Single User expiry date and group

To set plan expiry and attach a group for each user, do the following:

1. Click **Users** &gt; **User Manager**.
2. Click the user for whom you want to set the membership expiry.
3. Click the **Additional Options** tab.
4. Provide the expiration date in the **Plan expiry** field.  
    <span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.comdev.eu/download/attachments/5735029/Membership_User_expiration.jpg)</span>
5. Click the **Assigned User Groups** tab.
6. Select the check box next to the group you want to attach the user to for a particular membership plan as shown in the following image.  
    <span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.comdev.eu/download/attachments/5735029/Membership_User_group.jpg)</span>
7. Click **Save**.

For more information about membership expiration setting, see [Configuration](http://confluence.comdev.eu/display/JD2/Configuration) documentation.