Contract and Asset Renewal Jobs #

Two daily background jobs handle contract auto-renewal and asset expiration reminders.

What DMSI Service Management Adds
Both jobs are new. Core manages subscription renewals through WooCommerce Subscriptions. Service Management adds separate contract-level auto-renewal logic and a dedicated asset expiration tracking system.

Contract Renewal Job #

Interval: Daily

The Contract Renewal job processes service contracts with the auto_renew flag set to true (1).

What It Does #

1. Queries all contracts where auto_renew = 1 and end_date <= today.
2. For each qualifying contract:
3. Extends the end date by the contract’s renewal period (typically 12 months).
4. Applies hour rollover logic: if the contract has a rollover_hours setting, any unused hours from the previous period are added to the new allocated_hours total (up to any configured cap).
5. Resets hour usage tracking for the new period.
6. Queues a contract-created email to notify the customer of the renewal.
7. Logs all renewals to the plugin activity log.

Manual Renewals #

Admin users can manually renew a contract from the Services > Contracts detail page without waiting for the daily job. Manual renewal uses the same logic as the automated job.

Asset Renewals Job #

Interval: Daily

The Asset Renewals job checks all active assets for upcoming expiration dates.

What It Does #

1. Queries all assets with status = active.
2. For each asset, calculates days until expiration.
3. If days until expiry equals the first reminder threshold (default: 30 days), queues an asset-expiring-soon email.
4. If days until expiry equals the second reminder threshold (default: 7 days), queues a second asset-expiring-soon email.
5. Updates asset status to expiring_soon when crossing the 30-day threshold.

Reminder Thresholds #

Expired Assets #

When an asset’s expiration date passes, the daily job updates its status to expired. An expired asset generates no further reminder emails.