# PPV Live Webcams Agent Integration

This plugin registers with VideoWhisper Site Manager through `vwsm_ai_plugin_integrations` and `vwsm_ai_plugin_option_integrations`.

## Site Manager Tools

Admin-only tools:

- `ppv_live_webcams_get_status`: returns PaidVideochat platform counters, main admin pages, role labels, custom post slug, profile fields, administrative record fields, and group modes.
- `ppv_live_webcams_settings_updated`: run after changing `VWliveWebcamsOptions`; refreshes rewrite rules for room slug changes, parses INI config strings into structured arrays, and simplifies group-mode parameters.

Moderator tools:

- `ppv_live_webcams_list_pending_performers`
- `ppv_live_webcams_approve_user`
- `ppv_live_webcams_reject_user`
- `ppv_live_webcams_set_user_suspended`

Performer tools:

- `ppv_live_webcams_list_my_rooms`
- `ppv_live_webcams_get_my_room`
- `ppv_live_webcams_update_my_room`

## Whitelisted Option

Site Manager Pro exposes `VWliveWebcamsOptions` as `ppv_live_webcams_options`.

Important sections:

- `customize`: role labels/slugs and `custom_post`
- `pages`: main plugin frontend pages
- `profile`: room profile fields, via `profileFieldsConfig` and `profileFields`
- `record`: administrative records, via `recordFieldsConfig` and `recordFields`
- `group`: chat modes, via `groupModesConfig` and `groupModes`

Agents should read the option first, update the complete option value, then call `ppv_live_webcams_settings_updated` with changed keys.

## Fitness Trainer Example

To configure a fitness trainer platform:

1. Change role labels in `VWliveWebcamsOptions`: performer/provider wording to trainer, client wording to client, and webcam/room wording to class where the option provides that label.
2. Update `custom_post` if room URLs should use a class-oriented slug.
3. Replace `profileFieldsConfig` with fields such as Fitness Objectives, Trainer Expertise, Class Style, Intensity, Equipment, and Schedule.
4. Replace `recordFieldsConfig` with trainer verification fields such as Certifications, Specializations, Insurance/Tax/Payout Details, and Admin Review Notes.
5. Keep `groupModesConfig` limited to current HTML5 Videochat and Webcam App parameters.
6. Call `ppv_live_webcams_settings_updated` with `custom_post`, `profileFieldsConfig`, `recordFieldsConfig`, and `groupModesConfig` as applicable.

## Group Mode Parameters

Keep only modern parameters used by the current HTML5 Videochat and Webcam App integrations:

`description`, `roomInterface`, `cpm`, `2way`, `cpm2`, `voyeur`, `cpmv`, `room_private`, `calls_only`, `requests_disable`, `room_conference`, `conference_auto`, `room_slots`, `vw_presentationMode`, `room_audio`, `room_text`, `group_disabled`, `stream_record`, `stream_record_private`, `stream_record_all`, `room_random`.