Skip to content

Mass Service Settings

Overview

Mass Service Settings allows you to update multiple subscribers' settings simultaneously instead of editing them one by one. This powerful bulk update feature saves time and ensures consistency across multiple subscriber accounts.

WHAT IS MASS SERVICE SETTINGS?

Mass Service Settings is a bulk update feature that:

  • Bulk Updates - Change settings for multiple subscribers at once
  • 23 Configurable Fields - Update profile, service, network, and infrastructure settings
  • Permission-Based - Respects user permissions and roles
  • Selective Updates - Only updates fields you specify
  • Efficient Processing - Handles hundreds of subscribers quickly

Perfect for: Bulk configuration changes, service migrations, network updates, infrastructure changes!


📋 Table of Contents

  1. How It Works
  2. Updatable Fields
  3. Permission Requirements
  4. Step-by-Step Process
  5. Field Details
  6. Best Practices

How It Works

The Process

1. Select Subscribers → 2. Click Mass Settings → 3. Choose Fields to Update → 
4. Enter New Values → 5. Submit → 6. System Updates All Selected Subscribers

What Gets Updated

Only Non-Empty Fields:

  • System only updates fields you fill in
  • Empty fields are ignored
  • Existing values preserved for empty fields

Example:

If you only fill in:
- Profile Status: Active
- SMS Status: Enabled

Only these 2 fields will be updated.
All other fields remain unchanged.

Updatable Fields

Profile & Status Fields (4 fields)

1. Profile Status (Admin/Staff only)

  • Register (1)
  • Active (2)
  • Disable (3)
  • Terminated (4)

2. SMS Status

  • Disabled (0)
  • Enabled (1)

3. Email Status

  • Disabled (0)
  • Enabled (1)

4. MAC Lock Status

  • Disabled (0)
  • Enabled (1)

Service & Connection Fields (4 fields)

5. Connection Type

  • 1 = Radius PPPoE
  • 2 = Radius Hotspot
  • 3 = API PPPoE
  • 4 = API Hotspot
  • 5 = API Static

6. Service Type

  • Service type ID

7. Salesperson

  • Salesperson/Reseller ID

8. Package

  • Package ID

Network & Technical Fields (2 fields)

9. NAS

  • Network Access Server ID

10. Expiration Date (Admin/Staff with permission)

  • Format: Y-m-d H:i:s
  • Only updates if subscriber already has expiration date
  • Updates both database and Radius

Data & Session Quota Fields (4 fields)

11. Total Data Quota

  • Total data allocation (MB)

12. Used Data Quota

  • Used data amount (MB)

13. Total Session Quota

  • Total session time (minutes)

14. Used Session Quota

  • Used session time (minutes)

Discount Fields (2 fields)

15. Discount Type

  • 1 = Percentage
  • 2 = Fixed Amount

16. Discount

  • Discount value (percentage or fixed)

Infrastructure Fields (7 fields)

17. Box Number

  • Distribution box number

18. Box Address

  • Box location address

19. Switch Board

  • Switch board name/number

20. Electric Socket

  • Power source information

21. Cable Type

  • Type of cable used

22. Uplink Port

  • Uplink port number

23. Fiber Code

  • Fiber cable code

24. Fiber Color

  • Fiber cable color

Permission Requirements

Admin Permissions

Can Update All Fields:

  • ✅ Profile Status
  • ✅ All service settings
  • ✅ Expiration date
  • ✅ All other fields

No Restrictions:

  • Can update any subscriber
  • Can change any setting

Staff Permissions

Can Update Most Fields:

  • ✅ Profile Status (if admin allows)
  • ✅ All service settings
  • ✅ Expiration date (if has permission)
  • ✅ All other fields

Restrictions:

  • Must have subscriber_expiration_date permission to update expiration
  • Can only update subscribers they have access to

Reseller Permissions

Can Update Limited Fields:

  • ❌ Cannot update Profile Status
  • ✅ Can update service settings
  • ❌ Cannot update expiration date
  • ✅ Can update other fields

Restrictions:

  • Can only update own subscribers
  • Can update subreseller/retailer subscribers
  • Cannot update other resellers' subscribers

Step-by-Step Process

Step 1: Select Subscribers

From All Subscribers Page:

  1. Go to Subscriber → All Subscribers
  2. Check boxes next to subscribers you want to update
  3. Or use "Select All" for all subscribers on page

Selection Tips:

  • Use filters to find specific subscribers
  • Can select across multiple pages
  • Selected IDs stored in comma-separated list

Step 2: Open Mass Settings

  1. Click "Mass Settings" button
  2. Mass settings form opens
  3. Selected subscriber IDs shown at top

Step 3: Choose Fields to Update

Important:

  • Only fill in fields you want to update
  • Leave other fields empty
  • Empty fields will be ignored

Example:

Want to update only SMS and Email status?
→ Fill in SMS Status: Enabled
→ Fill in Email Status: Enabled
→ Leave all other fields empty

Step 4: Enter New Values

For Each Field You Want to Update:

  1. Select or enter new value
  2. Double-check the value
  3. Ensure format is correct

Field-Specific Notes:

  • Profile Status: Dropdown (Admin/Staff only)
  • SMS/Email/MAC Status: Dropdown (0 or 1)
  • Connection Type: Dropdown (1-5)
  • Salesperson/Package/NAS: Dropdown (select from list)
  • Expiration Date: Date picker (Y-m-d H:i:s)
  • Quotas: Number input (MB or minutes)
  • Discount: Number input
  • Infrastructure: Text input

Step 5: Submit Update

  1. Review all filled fields
  2. Click "Submit" button
  3. System processes updates
  4. Wait for confirmation

Processing:

  • Updates each subscriber one by one
  • Skips subscribers without permission
  • Updates Radius if expiration changed
  • Counts successful updates

Step 6: Review Results

Success Message:

Successfully Mass Updated (X) Subscribers.

What Happened:

  • X = Number of subscribers successfully updated
  • Subscribers without permission skipped
  • Invalid subscribers skipped
  • All valid subscribers updated

Field Details

Profile Status (Admin/Staff Only)

What: Subscriber account status Values:

  • 1 = Register (New, not activated)
  • 2 = Active (Service active)
  • 3 = Disable (Temporarily disabled)
  • 4 = Terminated (Permanently closed)

Permission: Only Admin and Staff can update Use Case: Bulk activate/disable/terminate subscribers


SMS Status

What: SMS notification status Values:

  • 0 = Disabled (No SMS)
  • 1 = Enabled (Receive SMS)

Use Case: Enable/disable SMS for multiple subscribers


Email Status

What: Email notification status Values:

  • 0 = Disabled (No emails)
  • 1 = Enabled (Receive emails)

Use Case: Enable/disable email notifications


MAC Lock Status

What: MAC address locking Values:

  • 0 = Disabled (No MAC lock)
  • 1 = Enabled (MAC locked)

Use Case: Enable/disable MAC locking for security


Connection Type

What: Type of internet connection Values:

  • 1 = Radius PPPoE
  • 2 = Radius Hotspot
  • 3 = API PPPoE
  • 4 = API Hotspot
  • 5 = API Static

Use Case: Migrate subscribers to different connection type


Service Type

What: Service type classification Value: Service type ID Use Case: Categorize subscribers by service


Salesperson

What: Assigned salesperson/reseller Value: Salesperson ID Use Case: Transfer subscribers to different salesperson


Package

What: Internet package assignment Value: Package ID Use Case: Change package for multiple subscribers Note: Does NOT activate or create invoice


NAS

What: Network Access Server Value: NAS ID Use Case: Move subscribers to different NAS


Expiration Date (Admin/Staff with Permission)

What: Service expiration date Format: Y-m-d H:i:s (e.g., 2025-01-31 23:59:59) Permission: Admin or Staff with subscriber_expiration_date permission Important Rules:

  • Only updates if subscriber already has expiration date
  • New subscribers (no expiration) will NOT be updated
  • Updates both database and Radius (Expiration attribute)

Use Case: Extend/reduce expiration for multiple subscribers


Total Data Quota

What: Total data allocation Unit: MB (Megabytes) Value: Number (e.g., 10240 for 10GB) Use Case: Set data quota for multiple subscribers


Used Data Quota

What: Used data amount Unit: MB (Megabytes) Value: Number Use Case: Reset or adjust used data


Total Session Quota

What: Total session time Unit: Minutes Value: Number (e.g., 3600 for 60 hours) Use Case: Set session quota for multiple subscribers


Used Session Quota

What: Used session time Unit: Minutes Value: Number Use Case: Reset or adjust used session time


Discount Type

What: Type of discount Values:

  • 1 = Percentage (e.g., 10%)
  • 2 = Fixed Amount (e.g., 100 BDT)

Use Case: Apply discount to multiple subscribers


Discount

What: Discount value Format: Number Examples:

  • If Type = Percentage: 10 (means 10%)
  • If Type = Fixed: 100 (means 100 BDT)

Use Case: Set discount amount


Box Number

What: Distribution box number Format: Text Use Case: Update box assignment for multiple subscribers


Box Address

What: Box location address Format: Text Use Case: Update box location information


Switch Board

What: Switch board name/number Format: Text Use Case: Update switch board assignment


Electric Socket

What: Power source information Format: Text Use Case: Document power source


Cable Type

What: Type of cable used Format: Text Use Case: Update cable type information


What: Uplink port number Format: Text Use Case: Update uplink port assignment


Fiber Code

What: Fiber cable code/ID Format: Text Use Case: Update fiber code information


Fiber Color

What: Fiber cable color Format: Text Use Case: Update fiber color information


Best Practices

Before Mass Update

1. Verify Subscriber Selection

✅ Double-check selected subscribers
✅ Use filters to narrow selection
✅ Review subscriber count
✅ Ensure correct subscribers selected

2. Plan Your Updates

✅ List fields you want to update
✅ Prepare new values
✅ Verify values are correct
✅ Test with small group first

3. Check Permissions

✅ Verify you have permission to update
✅ Check field-specific permissions
✅ Confirm subscriber access rights

During Mass Update

1. Fill Only Required Fields

✅ Only fill fields you want to change
✅ Leave other fields empty
✅ Empty fields will be ignored
✅ Reduces risk of accidental changes

2. Double-Check Values

✅ Verify dropdown selections
✅ Check date format
✅ Validate numbers
✅ Review text entries

3. Start Small

✅ Test with 5-10 subscribers first
✅ Verify results
✅ Then proceed with larger batches

After Mass Update

1. Verify Updates

✅ Check subscriber profiles
✅ Verify fields updated correctly
✅ Test connections if needed
✅ Review Radius if expiration changed

2. Monitor for Issues

✅ Check for connection problems
✅ Verify service continuity
✅ Monitor for errors
✅ Address issues promptly

3. Document Changes

✅ Note what was changed
✅ Record date and time
✅ Keep audit trail
✅ Document reasons

Common Use Cases

Use Case 1: Enable SMS for All Subscribers

Scenario:

Want to enable SMS notifications for 500 subscribers

Steps:

  1. Select all 500 subscribers
  2. Click Mass Settings
  3. Set SMS Status: Enabled (1)
  4. Leave all other fields empty
  5. Submit

Result:

  • SMS Status updated to Enabled
  • All other fields unchanged
  • 500 subscribers now receive SMS

Use Case 2: Migrate to Different NAS

Scenario:

Moving 200 subscribers from NAS 1 to NAS 5

Steps:

  1. Filter subscribers by NAS 1
  2. Select all 200 subscribers
  3. Click Mass Settings
  4. Set NAS: 5
  5. Leave all other fields empty
  6. Submit

Result:

  • NAS updated to 5
  • All other fields unchanged
  • 200 subscribers now on NAS 5

Use Case 3: Transfer to New Salesperson

Scenario:

Transferring 100 subscribers from Salesperson A to Salesperson B

Steps:

  1. Filter subscribers by Salesperson A
  2. Select all 100 subscribers
  3. Click Mass Settings
  4. Set Salesperson: Salesperson B ID
  5. Leave all other fields empty
  6. Submit

Result:

  • Salesperson updated to B
  • All other fields unchanged
  • 100 subscribers now under Salesperson B

Use Case 4: Extend Expiration for Multiple Subscribers

Scenario:

Extending expiration by 1 month for 50 subscribers

Steps:

  1. Select 50 subscribers
  2. Click Mass Settings
  3. Set Expiration Date: 2025-02-28 23:59:59
  4. Leave all other fields empty
  5. Submit

Result:

  • Expiration date updated
  • Radius updated automatically
  • 50 subscribers now expire on Feb 28

Use Case 5: Apply Discount to Group

Scenario:

Applying 10% discount to 30 corporate subscribers

Steps:

  1. Select 30 corporate subscribers
  2. Click Mass Settings
  3. Set Discount Type: 1 (Percentage)
  4. Set Discount: 10
  5. Leave all other fields empty
  6. Submit

Result:

  • Discount type set to Percentage
  • Discount set to 10%
  • 30 subscribers now have 10% discount

Summary

Mass Service Settings is a powerful bulk update feature that:

✅ 23 Updatable Fields:

  • Profile & status (4 fields)
  • Service & connection (4 fields)
  • Network & technical (2 fields)
  • Data & session quota (4 fields)
  • Discount (2 fields)
  • Infrastructure (7 fields)

✅ Selective Updates:

  • Only updates filled fields
  • Empty fields ignored
  • Preserves existing values
  • Reduces accidental changes

✅ Permission-Based:

  • Respects user roles
  • Admin: Full access
  • Staff: Most fields
  • Reseller: Limited fields

✅ Efficient Processing:

  • Handles hundreds of subscribers
  • One-by-one processing
  • Skips unauthorized
  • Counts successful updates

✅ Radius Integration:

  • Updates Radius expiration
  • Maintains synchronization
  • Automatic updates

Perfect for ISPs wanting to efficiently manage multiple subscribers with bulk configuration changes!

www.onezeroart.com