You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: website/docs-v6/apps-and-extensions/apps/app_changepasswords.md
+2-4Lines changed: 2 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,7 +43,7 @@ Once you have installed the App, you will need to enable it. There are **two** w
43
43
44
44
**Option A:** Go to the **J2Commerce** icon at the top right corner **-> Apps**
45
45
46
-
**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Dashboard -> Apps**
46
+
**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Apps**
47
47
48
48
49
49
@@ -69,14 +69,12 @@ After adjusting settings, click **Save** or **Save & Close**.
69
69
70
70
When a logged-in customer visits their **My Account** page on the frontend, a **Change Password** tab appears in the profile navigation alongside any other profile tabs.
71
71
72
-
<!-- SCREENSHOT: Frontend My Profile page showing Change Password tab in the tab navigation -->
73
-
74
72
Clicking the tab reveals a simple form with two fields:
75
73
76
74
-**New Password** — the customer's desired new password
77
75
-**Confirm Password** — must match the New Password field exactly
78
76
79
-
<!-- SCREENSHOT: Change Password tab content showing New Password, Confirm Password fields and the Change Password button -->
description: "Automatically add customers to Joomla user groups when they purchase products — useful for membership sites, wholesale access, and ACL-controlled content."
6
-
---
7
-
8
1
# Add to User Group
9
2
10
3
The Add to User Group app plugin automatically adds a customer to one or more Joomla user groups as soon as their order reaches a status you choose. You can set groups at the individual product level, at the Joomla content category level, or both. Category settings always take priority over product settings.
11
4
12
5
Common uses include granting access to a members-only content area after purchase, upgrading a customer to a wholesale or dealer group, and controlling what ACL-restricted pages a buyer can see based on what they have bought.
13
6
14
-
## Installation
15
-
16
-
This plugin is a separate add-on available from the [J2Commerce Extensions Store](https://www.j2commerce.com). It is not included with the core J2Commerce 6 component.
17
-
18
-
1. Purchase and download the `app_usergroup.zip` package from the J2Commerce website.
19
-
2. Go to **System** -> **Install** -> **Extensions**.
20
-
3. Upload the `app_usergroup.zip` package file.
21
-
4. The plugin installs and enables automatically.
7
+
## Requirements
22
8
23
-
After installation, go to **J2Commerce** -> **Apps** to configure it.
9
+
- with PHP 8.3.0 +
10
+
- Joomla! 6.x
11
+
- J2Commerce 6.x
24
12
25
13
## Prerequisites
26
14
27
-
- J2Commerce 6 installed and configured.
15
+
- J2Commerce 6 is installed and configured.
28
16
- At least one product created.
29
-
- The Joomla user groups you want to assign must already exist. Create them under **System** -> **User Groups** before proceeding.
17
+
- The Joomla user groups you want to assign must already exist. Create them under **Users ->****Groups** before proceeding.
18
+
19
+
20
+
21
+
## Purchase and Download
22
+
23
+
**Step 1:** Go to our [**J2Commerce** website](https://www.j2commerce.com/)**->****Apps**
24
+
25
+
**Step 2:** Locate the `app_usergroup.zip` App **->** click **View Details****->****Add to cart -> Checkout**. 
26
+
27
+
**Step 3:** Go to your **My Downloads** under your profile button at the top right corner and search for the app. Click **Available Versions -> View Files -> Download Now**
28
+
29
+
## Install the App
30
+
31
+
You can install the App using the Joomla installer. The following steps help you with a successful installation.
32
+
33
+
In the Joomla admin, go to **System -> Install -> Extensions**
34
+
35
+
Upload the `app_usergroup.zip` file or use the Install from URL option.
@@ -35,65 +43,97 @@ After installation, go to **J2Commerce** -> **Apps** to configure it.
35
43
3. Assign user groups to each product, or to a content category.
36
44
4. Test by placing an order and confirming the customer lands in the right group.
37
45
38
-
---
46
+
***
47
+
48
+
## Enable the App
49
+
50
+
Once you have installed the App, you will need to enable it. There are **three** ways you can access the extension. 
51
+
52
+
**Option A:** Go to the **J2Commerce** icon at the top right corner **-> Apps**
53
+
54
+
**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Apps**
55
+
56
+
**Option C:** Go to **System****-> Manage -> Plugins**.
57
+
58
+
59
+
60
+
Search for **Add to User Group**.
39
61
40
-
## Step 1: Enable and Configure the Plugin
62
+
Look for **Custom Accordions**, click the **X,**and it will turn into a green checkmark. It is now enabled and ready for setup.
41
63
42
-
1. Go to **System** -> **Manage** -> **Plugins**.
43
-
2. Search for **Add to User Group**.
44
-
3. Click the plugin name to open its settings.
64
+
45
65
46
-
<!-- SCREENSHOT: Plugin Manager search results showing "Add to User Group" plugin with status toggle -->
66
+
## Configure the App
47
67
48
68
### Plugin Settings
49
69
50
-
| Setting | Description | Default |
51
-
|---------|-------------|---------|
52
-
|**Order Status**| The order statuses that trigger user group assignment. When an order reaches any of the selected statuses, the customer is added to the configured groups. Select one or more statuses. | Confirmed (status ID 1) |
53
-
|**Debug Mode**| When enabled, the plugin writes detailed log entries to a file named `app_usergroup.php` in the Joomla logs directory. Turn this on when troubleshooting; disable it in production. | No |
70
+
Click the plugin name to open its settings.
54
71
55
-
<!-- SCREENSHOT: Plugin settings form showing Order Status multi-select and Debug Mode toggle -->
72
+
56
73
57
-
**Choosing the right order status:**
58
-
Most stores use **Confirmed** or **Processing** as the trigger. Using **Pending** may add customers to groups before payment is verified. Using a completed/shipped status means customers wait longer for access. Choose the status that matches your fulfillment workflow.
74
+
**Order Status:** The order statuses that trigger user group assignment. When an order reaches any of the selected statuses, the customer is added to the configured groups. Select one or more statuses.
59
75
60
-
4. Click **Save** when finished.
76
+
**Debug Mode:**When enabled, the plugin writes detailed log entries to a file named `app_usergroup.php` in the Joomla logs directory. Turn this on when troubleshooting; disable it in production.
61
77
62
-
---
78
+
:::tip
63
79
64
-
## Step 2: Assign User Groups to Products
80
+
**Tip**: **Choosing the right order status:** Most stores use **Confirmed** or **Processing** as the trigger. Using **Pending** may add customers to groups before payment is verified. Using a completed/shipped status means customers wait longer for access. Choose the status that matches your fulfillment workflow.
81
+
82
+
:::
83
+
84
+
## Assign User Groups to Products
65
85
66
86
For each product that should trigger a group assignment, open the product and set the groups in the plugin's tab.
67
87
68
-
1. Go to **J2Commerce** -> **Catalog** -> **Products**.
69
-
2. Click the product name to edit it.
70
-
3. Scroll down to find the **Add to User Group** tab or panel.
71
-
4. In the **User Group List** field, select one or more groups from the dropdown.
88
+
There are **three** ways you can access the products. 
89
+
90
+
**Option A:** Go to the **J2Commerce** icon at the top right corner **-> Catalog -> Products**
91
+
92
+
**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Products**
93
+
94
+
**Option C:** Go to **Content -> Categories ->** Find the **category** and then click inside the **published**/article section
95
+
96
+
97
+
98
+
- Click on the product name to edit it.
99
+
100
+
Go to the **J2Commerce** tab **-> Apps** tab
101
+
102
+
- Scroll down to find the **Add to User Group** app.
103
+
104
+
72
105
73
-
<!-- SCREENSHOT: Product edit form showing the "Add to User Group" panel with the User Group List multi-select dropdown -->
106
+
- In the **User Group List** field, select one or more groups from the dropdown.
74
107
75
-
5. Click **Save** or **Save & Close**.
108
+
76
109
77
-
Repeat this for every product that should grant group membership on purchase. Products with no groups selected are simply ignored by this plugin.
110
+
:::info
78
111
79
-
---
112
+
**Note**: Repeat this for every product that should grant group membership on purchase. Products with no groups selected are simply ignored by this plugin.
80
113
81
-
## Step 3: Assign User Groups at the Category Level (Optional)
114
+
:::
115
+
116
+
## Assign User Groups at the Category Level (Optional)
82
117
83
118
If you have a whole category of products that should all grant the same group, you can set the groups once on the category instead of repeating the setting on each product. When category groups are present, they take over completely — the product-level setting is ignored for that item.
84
119
85
-
1. Go to **Content** -> **Categories**.
86
-
2. Click the category that contains your products.
87
-
3. Find the **Add To User Groups** tab in the category editor.
88
-
4. In the **User Group List** field, select one or more groups.
120
+
Go to **Content -> Categories**
121
+
122
+
123
+
124
+
Click the category that contains your products.
125
+
126
+
Find the **Add To User Groups** tab in the category editor.
127
+
128
+
In the **User Group List** field, select one or more groups.
89
129
90
-
<!-- SCREENSHOT: Joomla category editor showing the "Add To User Groups" tab with the group selector -->
130
+
91
131
92
-
5. Click **Save & Close**.
132
+
:::info
93
133
94
134
**Priority rule:** If a product belongs to a category that has groups configured, those category groups are used and any product-level groups are ignored. If the category has no groups set, the product-level groups are used as the fallback.
95
135
96
-
---
136
+
:::
97
137
98
138
## How It Works
99
139
@@ -108,62 +148,55 @@ When an order's status changes to one of the statuses you configured:
108
148
109
149
The plugin handles duplicate group assignments gracefully — if the customer is already in a group, nothing breaks.
110
150
111
-
Guest customers (users who checked out without a Joomla account) are skipped because there is no Joomla user ID to assign a group to.
151
+
:::info
112
152
113
-
---
153
+
**Note:** Guest customers (users who checked out without a Joomla account) are skipped because there is no Joomla user ID to assign to a group.
154
+
155
+
:::
114
156
115
157
## Use Case Examples
116
158
117
159
### Members-Only Digital Access
118
160
119
-
You sell a digital subscription product. Your Joomla site has a **Members** group that can access restricted articles.
161
+
You sell a digital subscription product. Your Joomla site has a **Members-Only** group that can access restricted articles.
120
162
121
-
- Create the **Members** user group under **System** -> **User Groups**.
163
+
- Create the **Members-Only** user group under **Users->****Groups**.
122
164
- Set appropriate **View Level** restrictions on your members-only articles.
123
-
- On the subscription product, select **Members** in the **User Group List**.
165
+
- On the subscription product, select **Members-Only** in the **User Group List**.
124
166
- Set the plugin's **Order Status** to **Confirmed**.
125
167
126
-
When a customer's order is confirmed, they are immediately added to the **Members** group and can view the restricted content on their next page load.
168
+
When a customer's order is confirmed, they are immediately added to the **Members-Only** group and can view the restricted content on their next page load.
127
169
128
170
### Wholesale Pricing by Category
129
171
130
172
You have a **Wholesale Products** category. Any customer who buys from it should be upgraded to your **Wholesale** group.
131
173
132
174
- Create the **Wholesale** group in Joomla.
133
-
- Open the **Wholesale Products** category in **Content** -> **Categories**.
175
+
- Open the **Wholesale Products** category in **Content -> Categories**.
134
176
- Set **Wholesale** in the **Add To User Groups** tab.
135
177
136
178
All products in that category will now trigger the group assignment on purchase — no need to configure each product individually.
137
179
138
-
---
139
-
140
180
## Troubleshooting
141
181
142
182
### The customer was not added to the group after purchase
143
183
144
-
**Check 1 — Order status match.** Open the order and note the current status. Go back to the plugin settings and confirm that status is selected in **Order Status**. If the order is **Pending** but you only have **Confirmed** selected, no assignment will happen until the order is confirmed.
145
-
146
-
**Check 2 — User group is set on the product or category.** Edit the product and check the **Add to User Group** panel. Make sure at least one group is selected. If the product belongs to a category with groups set, the category groups override the product — verify the category setting too.
184
+
-**Check 1 — Order status match.** Open the order and note the current status. Go back to the plugin settings and confirm that status is selected in **Order Status**. If the order is **Pending** but you have only **Confirmed** selected, no assignment will happen until the order is confirmed.
147
185
148
-
**Check 3 — Guest checkout.**If the customer placed the order as a guest (no Joomla account), the plugin cannot assign a group. The plugin only works for registered users with a valid Joomla user ID.
186
+
-**Check 2 — User group is set on the product or category.**Edit the product and check the **Add to User Group** panel. Make sure at least one group is selected. If the product belongs to a category with groups set, the category groups override the product — verify the category setting too.
149
187
150
-
**Check 4 — Enable debug mode.**In the plugin settings, turn on **Debug Mode** and reproduce the issue by manually changing the order status. Then open the file `[joomla-root]/logs/app_usergroup.php` in a text editor and look for log entries related to that order.
188
+
-**Check 3 — Guest checkout.**If the customer placed the order as a guest (no Joomla account), the plugin cannot assign a group. The plugin only works for registered users with a valid Joomla user ID.
151
189
152
-
---
190
+
-**Check 4 — Enable debug mode.** In the plugin settings, turn on **Debug Mode** and reproduce the issue by manually changing the order status. Then open the file `[joomla-root]/logs/app_usergroup.php` in a text editor and look for log entries related to that order.
153
191
154
192
### Debug Mode shows "Status X not in configured statuses"
155
193
156
-
The order status ID does not match any of the statuses you selected in the plugin. Open the plugin settings, expand **Order Status**, and add the status ID shown in the log entry.
194
+
**Cause:**The order status ID does not match any of the statuses you selected in the plugin. 
157
195
158
-
---
196
+
**Solution:** Open the plugin settings, expand **Order Status**, and add the status ID shown in the log entry.
159
197
160
198
### A product in the category is not triggering the category groups
161
199
162
-
The category-level setting only applies to products sourced from Joomla content articles (the standard J2Commerce product type linked to `com_content`). Confirm the product was created through the standard J2Commerce workflow and is linked to a content article in the correct category.
163
-
164
-
---
165
-
166
-
## Related Topics
200
+
**Cause:** The category-level setting only applies to products sourced from Joomla content articles (the standard J2Commerce product type linked to `com_content`). 
![dhub-sync[bot]](https://avatars.githubusercontent.com/in/391097?v=4&size=40){kind=avatar}
0 commit comments