vex/simple-lock-toggle
1
0
Fork 0
mirror of https://codeberg.org/vex/simple-lock-toggle.git synced 2025-12-11 19:07:47 +01:00
Code Issues Projects Releases Packages Wiki Activity
No description
1 commit 1 branch 0 tags 31 KiB
Find a file
Exact
Vratislav Hutsky 87c4b579e9 initial commit
2025-10-20 22:02:11 +02:00
js initial commit 2025-10-20 22:02:11 +02:00
README.md initial commit 2025-10-20 22:02:11 +02:00
simple-lock-toggle.php initial commit 2025-10-20 22:02:11 +02:00

README.md

Simple Lock Toggle

Contributors: Vratislav Hutsky
Plugin URI: https://codeberg.org/vex/simple-lock-toggle
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple WordPress plugin that adds a lock/unlock button to the admin interface and writes the current state to a file.

Description

Simple Lock Toggle provides a straightforward way for site administrators to toggle a system-wide lock state. This state is saved as a simple integer (0 for unlocked, 1 for locked) in a file located in the wp-content/uploads directory.

This plugin is useful for developers who need a simple, file-based flag that can be checked by other plugins, themes, or external scripts to enable or disable specific functionalities.

Features

  • Adds a "Lock/Unlock" button to the WordPress admin bar for quick access.
  • Provides a dedicated admin page under the "Lock Toggle" menu to view the current status and file path.
  • Saves the lock state to wp-content/uploads/lock_state.txt.
  • Uses AJAX, so toggling the state happens instantly without a page reload.
  • Implemented using WordPress nonces.
  • Functionality is restricted to users with manage_options capability (typically administrators).

Installation

  1. Upload the simple-lock-toggle folder to the /wp-content/plugins/ directory on your web server.
  2. Activate the plugin through the 'Plugins' menu in your WordPress admin dashboard.
  3. Upon activation, the plugin will attempt to create the lock_state.txt file in your wp-content/uploads directory. Please ensure this directory is writable by the web server.

Usage

Once the plugin is activated:

  • A lock/unlock button (🔒 / 🔓) will appear in the top admin bar for logged-in administrators.
  • Click this button to toggle the lock state. The button text and icon will update automatically.
  • To see more details, navigate to the Lock Toggle menu item in the left-hand admin sidebar. This page displays the current status (LOCKED/UNLOCKED), the exact path to the lock file, and the raw value stored within it.

You can then use any file-reading function in your other PHP or bash scripts to check the contents of wp-content/uploads/lock_state.txt and alter behavior accordingly.

License

This plugin is licensed under the GNU General Public License v2 or later. See the license file for more details.