Common Admin Tasks

View Categories

Common Admin Tasks

1 min read

Common Admin Tasks #

Quick reference for frequent administrative operations.

Task 1: Customer Reports Auto-Update Not Working #

Steps:

  1. Confirm the extension license is valid (DDLS > Settings > Update Server)
  2. Check the customer's license status (DDLS > Licenses)
  3. Verify the version is published and has a file uploaded
  4. Check the version's rollout percentage (does the customer's license fall in the rollout bucket?)
  5. Check the version's channel vs. the customer's license channel
  6. Ask the customer what version of your software they are running (compare to current_version in their update check request)
  7. Test the API manually with their license key and product ID

Task 2: Immediately Release an Update to All Customers #

Steps:

  1. Edit the version
  2. Check that Rollout is 100%
  3. If rollout is below 100%: click Full Rollout in the Versions list row actions
  4. If you want to notify all customers right now: edit the version, check "Send Email Notification," and resave (if emails were not already sent)

Task 3: Stop a Bad Release #

Symptom: A new version you published has a critical bug and you need to stop customers from downloading it.

Steps:

  1. Go to DDLS > Versions
  2. Find the version
  3. Edit it and set Rollout Percentage to 0 — this immediately stops the update from being delivered
  4. Alternatively: trash (unpublish) the version to remove it from the versions list entirely
  5. Create a fixed version as soon as possible

Note: Setting rollout to 0 does not affect customers who already downloaded the version.

Task 4: Customer Cannot Access Portal Updates Section #

Steps:

  1. Confirm the customer is logged into the portal
  2. Confirm the customer has at least one active license
  3. Go to DDLS > Settings > Update Server and confirm the extension license is valid
  4. Check that the portal pages were registered (if using custom page setup, the portal integration hooks may need rewriting — deactivate and reactivate the plugin to re-register)
  5. Flush rewrite rules (Settings > Permalinks > Save)

Task 5: Clearing the Update Check Cache #

If a customer or client needs to receive a fresh update check result immediately (before the 15-minute cache expires):

  1. In code: call delete_transient("dmsilm_us_uc_{md5(product_id.current_version.channel)}")
  2. Or: use a WP-CLI command: wp transient delete --all (clears all transients — use carefully on production)
  3. Or: wait for the cache to expire naturally

Related Topics #

Leave a Reply