wvnderlab-agency / wp-custom-login

dev-master 2026-09-24 12:04 UTC

Requires

• php: >=8.0

Requires (Dev)

• wp-coding-standards/wpcs: ^3.0

MIT

• johninamillion

• wordpress
• wordpress-plugin
• wordpress-muplugin

Published on Packagist.org on 2026-09-24 13:56 UTC

README

• Installation
• Usage
• Development

Installation

Via Composer

composer require wvnderlab-agency/wp-custom-login

Via FTP

1. Download the repository zip file.
2. Unzip the file.
3. Upload the unzipped folder to the /wp-content/muplugins or /wp-content/plugins/ directory on your server.
4. Navigate to the 'Plugins' section in your WordPress admin dashboard.
5. Find 'Disable posts' in the list and click 'Activate'.

Via WordPress Admin Dashboard

1. Download the repository zip file.
2. Navigate to the 'Plugins' section in your WordPress admin dashboard.
3. Click 'Add New' and then 'Upload Plugin'.
4. Choose the downloaded zip file and click 'Install Now'.
5. After installation, click 'Activate Plugin'.

Usage

Config

WV_CUSTOM_LOGIN_PATH (Default: null)

This constant allows you to set a custom login URL slug. If not defined, the default slug 'admin-login' will be used.

// define the custom login URL slug
define( 'WV_CUSTOM_LOGIN_PATH', 'custom-login' );

Filter Hooks

wvnderlab/custom-login/slug (Default: 'admin-login')

This filter allows you to change the slug of the custom login URL.

// change the slug to 'custom-login'
add_filter( 'wvnderlab/custom-login/slug', fn( string $slug ) => 'custom-login' );

wvnderlab/custom-login/login-logo-background-image (Default: 'custom-logo-url'|'site-icon-url')

This filter allows you to change the background image of the login logo. By default, it uses the custom logo URL if available, otherwise it falls back to the site icon URL.

// change the login logo background image to a custom URL
add_filter( 'wvnderlab/custom-login/login-logo-background-image', fn( string $background_image ) => 'https://example.com/path/to/custom-logo.png' );

wvnderlab/custom-login/login-logo-border-radius (Default: '0'|'8px')

This filter allows you to change the border radius of the login logo. By default, it is set to '0', but you can change it to any valid CSS border-radius value.

// change the login logo border radius to '12px'
add_filter( 'wvnderlab/custom-login/login-logo-border-radius', fn( string $border_radius ) => '12px' );

wvnderlab/custom-login/login-logo-logo-width (Default: 'auto'|'8px')

This filter allows you to change the width of the login logo. By default, it is set to 'auto', but you can change it to any valid CSS width value.

// change the login logo width to '150px'
add_filter( 'wvnderlab/custom-login/login-logo-logo-width', fn( string $width ) => '150px' );

Development

Install Dependencies

composer install

Analyse Code-Quality with WP-Coding-Standards

composer analyze

Refactor Code along WP-Coding-Standards

composer refactor