hyyan/logo-controller

Wordpress plugin to add new option for the theme customizer allowing the user to change th logo in website and the login page

Monday, March 16, 2015
by hyyan
Repository
1 Watchers
1 Stars
72 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
5 Versions
0 % Grown

The README.md

Wordpress Logo Controller

, _(*1)

Wordpress plugin to add new section for the customizer to allow the user to change the logo for website and login page., _(*2)

, _(*3)

How to install

Classical way

Download the plugin as zip archive and then upload it to your wordpress plugins folder and extract it there.
Activate the plugin from your admin panel

Composer way

run composer command : composer require hyyan/logo-controller

How to use

Plugin configutaion

The plugin comes with following configuration as default :, _(*4)

$default = array(
    // path for default logo 
    'default' => '/logo.png',
    //the logo url (default to home page)
    'url' => home_url('/'),
    // the logo desciption default to (get_bloginfo('name', 'display')) 
    'description' => get_bloginfo('name', 'display'),
    // enable logo display on the login page
    'enable-on-login-page' => true,
);

You can override the default configuration using add_filter function like in the following example :, _(*5)

// in the your theme's functions.php file

add_filter('Hyyan\LogoController.options', function(array $default) {

    $default['default'] = '/my-logo.png';
    $default['enable-on-login-page'] = false;

    return $default;
});

Display the logo in your theme

The plugin does not make any assumption about the place of your logo so you have to add it manually , probably in your header.php template., _(*6)

<?php 

 // in you theme template use the following functions to get the logo

// print : http://example.com/path/to/logo.png 
 echo hyyan_get_the_logo(); 

// print : <img src="http://example.com/path/to/logo.png" alt="Website Title">    
 hyyan_the_logo();