TB.Umbraco.ContentLock 17.1.1-autolockv2

Umbraco Community ContentLock

Umbraco Community ContentLock is an open-source package for Umbraco CMS that prevents content conflicts by enabling content editors to lock nodes while editing. This ensures that changes are made by a single user at a time, reducing the risk of overwriting each other’s work.

Features

• Intuitive Lock/Unlock Actions:

  • Lock or unlock content nodes directly from the node actions (top right) or the tree view.

• Auto Lock (opt-in):

  • Automatically locks a node as soon as an editor changes it, releasing it on save, leaving the node, disconnect, or after a configurable inactivity timeout.
  • Warns an editor (by name) if another user removes the lock while they are still editing.

• Comprehensive Audit Trail:

  • Every lock and unlock action is logged in the node history for complete traceability.

• Enhanced Permission Management:

  • Introduces new permissions that allow users to override locks when needed
  • New permission is added to the Administrators user group when first installed

• Dashboard Overview:

  • Access a dedicated dashboard in the content section to view all currently locked nodes.
  • Users with permission can override one or more locked nodes from this dashboard

• User Notifications:

  • Users are informed via a footer message when a node is locked.

• Read-Only Mode for Locked Nodes:

  • Locked nodes display all content (across all variants) as read-only.

• Action Restrictions:

  • Prevents actions like publish, unpublish, and save for nodes that are currently locked.

• Audio Calling (17.1.0+):

  • Peer-to-peer WebRTC voice calls between backoffice editors directly from the Online Users modal.
  • No external software required for editors on the same network; TURN server support available for remote workers.

Options

Content Lock has the following options available to configure.

AppSettings

...
"ContentLock": {
  "SignalRClientLogLevel": "Info",
  "AutoLock": {
    "Enable": false,
    "InactivityTimeoutSeconds": 300,
    "HeartbeatSeconds": 60
  },
  "OnlineUsers": {
    "Enable": true,
    "Sounds": {
      "Enable": true,
      "LoginSound": "/App_Plugins/ContentLock/sounds/login.mp3",
      "LogoutSound": "/App_Plugins/ContentLock/sounds/logout.mp3"
    }
  },
  "WebRTC": {
    "Enable": true,
    "StunServers": [
      "stun:stun.l.google.com:19302",
      "stun:stun.cloudflare.com:3478"
    ],
    "RingTimeoutSeconds": 20,
    "TurnServer": {
      "Provider": "None"
    },
    "Sounds": {
      "RingSound": "/App_Plugins/ContentLock/sounds/ringtone.mp3",
      "RingbackSound": "/App_Plugins/ContentLock/sounds/ringtone.mp3"
    }
  }
}

Environment Variables

ContentLock__SignalRClientLogLevel=Info
ContentLock__AutoLock__Enable=false
ContentLock__AutoLock__InactivityTimeoutSeconds=300
ContentLock__AutoLock__HeartbeatSeconds=60
ContentLock__OnlineUsers__Enable=true
ContentLock__OnlineUsers__Sounds__Enable=true
ContentLock__OnlineUsers__Sounds__LoginSound=https://some-snazzy-sound.com/sfx-login.mp3
ContentLock__OnlineUsers__Sounds__LogoutSound=/App_Plugins/SomePlace/logout.mp3
ContentLock__WebRTC__Enable=true
ContentLock__WebRTC__RingTimeoutSeconds=20
ContentLock__WebRTC__TurnServer__Provider=None
ContentLock__WebRTC__TurnServer__Sounds__RingSound=/App_Plugins/ContentLock/sounds/ringtone.mp3
ContentLock__WebRTC__TurnServer__Sounds__RingbackSound=/App_Plugins/ContentLock/sounds/ringtone.mp3

Reactive Options

For example you could change the value OnlineUsers.Enable and this will instantly toggle the number of connected users in the backoffice in the top right of Umbraco. You can see this in action here and how it was coded if you are curious:

Attributions

• Log on sound: Piano Notification 3 by FoolBoyMedia
  • https://freesound.org/s/352651/
  • License: Attribution NonCommercial 4.0
• Log off sound: Dist Kalimba.wav by JFRecords
  • https://freesound.org/s/420521/
  • License: Attribution 3.0
• Ringtone sound: Piano Notification 5b by FoolBoyMedia
  • https://freesound.org/s/352654/
  • License: Attribution NonCommercial 4.0

Fork Notice

This package is a community-driven fork of the original CogWorks ContentGuard project, modified for the modern Umbraco Bellissima backoffice. Special thanks to the team at CogWorks and the original developer Marcin Zajkowski for laying the groundwork and supporting this update.

Lovingly crafted for you by Warren Buckley ❤️

Available for hire