The site's languages : [ar] [en] [es] [fr] [it]

À propos de SPIP

SPIP

SPIP Blog

SPIP Démo

SPIP Doc

SPIP Forums

SPIP Herbier

SPIP Irc

SPIP Party

SPIP Sedna

SPIP Test-GrmlEU

SPIP User

SPIP Zone

Home page > Admin and maintenance solutions

Additional administration buttons in a plugin

Sunday 4 February 2007, by Loiseau2nuit. Latest addition Sunday 4 February 2007

All the versions of this article:

This plugin will add a few additional administration buttons to your SPIP site’s public area. These buttons will allow you to directly edit the content of an article or section, access a private area from anywhere in your site, or create a new article (among other things) without having to leave the “public side” of your site.

Plugin updates : See on bottom.

Description

The plugin will also allow you to show or hide the full button bar with a click of a button, so you can free up some screen space while in the site’s public area. Your preference for the button bar ("visible" or "hidden") is saved in a cookie so the only time you will have to set this option is the first time you use it.

The technology at work in this plugin (which overrides file formulaire_admin.html) is not new or unique; it is already in use and explained here. The only difference is that it now works as a plugin and there is no need to modify any files or templates, and it also allows for easy upgrades.

The text on the buttons is localized, and is displayed in your chosen language. The "show/hide" capability is quite new and uses javascript.

Please note that all edits made using this plugin are automatically classified in the section you are visiting on the public side of your site.

This plugin is distributed under the GNU/GPL licence.

Installation

As for any other plugin, you just need to download following archive, unzip it, and move extracted folder to SPIP’s /plugins directory. The plugin must be activated through the private area.

Please refer to the Spip official documentation for any further detail concerning plugins.

New buttons available

The plugin proposes following options, some of these appearing according to the context. Bold descriptions indicates that the button appears only for administrators who activated their administration cookie, and not to contributors who have no rights to perform such action :

XML debugger ;
Write a new article (in active section) ;
Create a new section (as a subsection of the active one) ;
Reference a new website (in active section) ;
Write a news item (in active section) ;
Edit content of active section, article, news item ;
Modify active section, article, keyword, referenced website, author ;
Refresh page () ;
Statistics ;
Preview ;
Acces private area (button appears on each page on not only on summary) ;
Template debugger ;
Logging out () ;
Hide () / Show () buttons bar.

Some of these buttons allready exists in spip’s core distribution.

A few screenshots

How to improve this plugin

Why not creating a configuration file which would let us choose the buttons we need and hide those that are not necessary and/or not often used.

Source Code

The most important file is formulaire_admin.html :

<?php
// The pictures come from an icon set by <http://icon-king.com/?p=15>
// and are distributed under licence LGPL <http://en.wikipedia.org/wiki/LGPL>
$img_montrer = '<img src="'.find_in_path('montrer.png').'" align="absmiddle" alt="Show the buttons bar" />';
$img_cacher = '<img src="'.find_in_path('cacher.png').'" align="absmiddle" alt="Hide the buttons bar" />';
$img_reload = find_in_path('reload_page.png');
$img_logout = find_in_path('exit.png');
?>

<div id="bouton_montrer" dir='#LANG_DIR' style="visibility:hidden; top:7px; right: 20px; position: absolute; background-color: transparent; z-index: 100;">
	<a href="#" onclick="javascript:masquer_boutons('visible')" title="Show the buttons bar"><?php echo($img_montrer); ?></a>
</div>
<div id="boutons_admin_supp" [class="(#ENV{divclass,spip-admin-bloc})" ]dir='#LANG_DIR'>
	[<a href='(#ENV{analyser})' class='spip-admin-boutons'><:analyse_xml:>[(#ENV{xhtml_error}|?{' *',''})]</a>]
	<a href='ecrire/?exec=articles_edit&new=oui[&id_rubrique=(#ENV{id_rubrique})]' class='spip-admin-boutons'><:icone_ecrire_article:></a>
	<?php
	if($GLOBALS['auteur_session']['statut'] == '0minirezo'){
	echo("
	<a href='ecrire/?exec=rubriques_edit&new=oui[&id_parent=(#ENV{id_rubrique})]' class='spip-admin-boutons'><:icone_creer_rubrique:></a>");
	}
	?>
	<a href='ecrire/?exec=sites_edit&new=oui[&id_rubrique=(#ENV{id_rubrique})]' class='spip-admin-boutons'><:info_sites_referencer:></a>
	<a href='ecrire/?exec=breves_edit&new=oui[&id_rubrique=(#ENV{id_rubrique})]' class='spip-admin-boutons'><:icone_nouvelle_breve:></a>
	<?php
 	if($GLOBALS['auteur_session']['statut'] == '0minirezo'){
	echo("[<a href='ecrire/?exec=rubriques_edit&id_rubrique=#ENV{id_rubrique}' class='spip-admin-boutons'>Edit ((#ENV{id_rubrique}))</a>]");
	echo("[<a href='ecrire/?exec=articles_edit&id_article=#ENV{id_article}' class='spip-admin-boutons'>Edit ((#ENV{id_article}))</a>]");
        echo("[<a href='ecrire/?exec=breves_edit&id_breve=#ENV{id_breve}' class='spip-admin-boutons'>Edit ((#ENV{id_breve}))</a> ]");
	echo("[<a href='[(#ENV{voir_breve})]' class='spip-admin-boutons'><:admin_modifier_breve:> ((#ENV{id_breve}))</a>]");
	echo("[<a href='[(#ENV{voir_rubrique})]' class='spip-admin-boutons'><:admin_modifier_rubrique:> ((#ENV{id_rubrique}))</a>]");
	echo("[<a href='[(#ENV{voir_article})]' class='spip-admin-boutons'><:admin_modifier_article:> ((#ENV{id_article}))</a>]");
	echo("[<a href='[(#ENV{voir_mot})]' class='spip-admin-boutons'><:admin_modifier_mot:> ((#ENV{id_mot}))</a>]");
	echo("[<a href='[(#ENV{voir_site})]' class='spip-admin-boutons'><:icone_modifier_site:> ((#ENV{id_syndic}))</a>]");
	echo("[<a href='[(#ENV{voir_auteur})]' class='spip-admin-boutons'><:admin_modifier_auteur:> ((#ENV{id_auteur}))</a>]");
	}
	?>
        [<a href="(#ENV{preview})" class="spip-admin-boutons"><:previsualisation:></a>]
	<a href='./ecrire' class='spip-admin-boutons'><:espace_prive:></a>
	<a href='[(#SELF|parametre_url{var_mode,#ENV{calcul}})]'><img align="absmiddle" src="<?php echo($img_reload); ?>" alt="<:admin_recalculer:>[(#ENV{use_cache})]" /></a>
	[<a href='(#ENV{statistiques})' class='spip-admin-boutons'>[<:info_visites:>&nbsp;(#ENV{visites})][;&nbsp;<:info_popularite_5:>&nbsp;(#ENV{popularite})]</a>]
	[<a href='[(#ENV{action})]var_mode=(#ENV{debug})' class='spip-admin-boutons'><:admin_debug:></a>]
	<a href='?action=logout'><img align="absmiddle" src="<?php echo($img_logout); ?>" alt="<:icone_deconnecter:>" /></a>
	<a href="#" title="Hide the buttons bar" onclick="javascript:masquer_boutons('hidden')" style="font-style:italic;"><?php echo($img_cacher); ?></a>
</div>
<?php
$localisation_fonctions_js = '<script src="'.find_in_path('fonctions_boutons_supp.js').'" type="text/javascript"></script>';
echo $localisation_fonctions_js;
?>

Javascript code allowing to hide/show the buttons is listed in fonctions_boutons_supp.js :

// Functions for Additional admin. buttons.
// Functions createCookie() and readCookie()
// were obtained from <http://www.quirksmode.org/js/cookies.html>
// respecting reproduction rights declared on
// <http://www.quirksmode.org/about/copyright.html> (free use)

function createCookie(name,value,days) {
	if (days) {
		var date = new Date();
		date.setTime(date.getTime()+(days*24*60*60*1000));
		var expires = "; expires="+date.toGMTString();
	}
	else var expires = "";
	document.cookie = name+"="+value+expires+"; path=/";
}

function readCookie(name) {
	var nameEQ = name + "=";
	var ca = document.cookie.split(';');
	for(var i=0;i < ca.length;i++) {
		var c = ca[i];
		while (c.charAt(0)==' ') c = c.substring(1,c.length);
		if (c.indexOf(nameEQ) == 0) return c.substring(nameEQ.length,c.length);
	}
	return null;
}

function masquer_boutons(valeur){
	maBarre_boutons=document.getElementById("boutons_admin_supp");
	monBouton_montrer=document.getElementById("bouton_montrer");

	if(valeur=="hidden"){
		if (document.all) { // Rustine pour IE6 -- la peste soit de ce navigateur
		document.all.boutons_admin_supp.style.visibility="hidden";
		document.all.bouton_montrer.style.visibility="visible";
		}
		else {
		maBarre_boutons.style.visibility = "hidden";
		monBouton_montrer.style.visibility = "visible";
		}
	createCookie("etat_des_boutons","hidden",7);
	}
	else if (valeur=="visible"){
		if (document.all) { // Rustine pour IE6 -- la peste soit de ce navigateur
		document.all.boutons_admin_supp.style.visibility="visible";
		document.all.bouton_montrer.style.visibility="hidden";
		}
		else {
		maBarre_boutons.style.visibility = "visible";
		monBouton_montrer.style.visibility = "hidden";
		}
	createCookie("etat_des_boutons","visible",7);
	}
}
var etat = readCookie("etat_des_boutons");
masquer_boutons(etat);

Updates

Version 1.4 - Feb. 4, 2007 : A slight bug that prevented to use show/hide option with Internet Explorer 6 was fixed. Buttons now disappear when you log out. This was basicely not the case before. When logged out, buttons still appeared but sent to the login page untill the administration cookie was detroyed, what happened when user asked to log in using a different ID.

Version 1.3 - Feb.3, 2007 First release of this plugin available in english.

P.S.

Plugin originally developped by Vincent RAMOS, following a contribution by Balluche.
This notice was translated from French by Etienne B..
Many thanks to Shelly from Spip-En mailing list for her help and correction work on this notice.

Reply to this article

Additional administration buttons in a plugin
30 July 2007 19:17, by reza ayati

hi i installed this plugins and acctive it in plugins setting but don’t show that’s icon in my site please guide me

Reply to this message
- Additional administration buttons in a plugin 31 July 2007 03:35, by Loiseau2nuit (formerly Zzz.)
  
  Hi,
  
  May you please be more precise ? Which icon can’t you see ? What’s your exact spip version ?
  
  Thanks for your feedbacks ;)
  
  Reply to this message
  - Additional administration buttons in a plugin 1 August 2007 18:41, by reza
    
    hi my spip ver is SPIP 1.9.2a & can’t see additional administration buttons for example XML debugger ; Write a new article (in active section) ; Create a new section (as a subsection of the active one) ; Reference a new website (in active section) ; Refresh page ( ) ; Statistics ; Preview ; Template debugger ; Logging out ( ) ; Hide ( ) / Show ( ) buttons bar. that you show in your article! sorry for my bad english :( !
    
    Reply to this message
    - Additional administration buttons in a plugin 2 August 2007 13:29, by Loiseau2nuit (formerly Zzz.)
      
      Yep ! I’ve noticed that the original contribution had been updated to be 1.9.2 complient but the author did not warn me. Give me some time to bring and translate the modifications then it will be available there.
      
      But if you can’t wait, you may download the French version of this contrib. here
      
      C.U. ;)
      
      Reply to this message
Back to the start of the forums

RSS 2.0 | Site Map | Private area | Charte et fonctionnement SPIP-Contrib |

| L'autre.net

Additional administration buttons in a plugin

Keywords

Description

Installation

New buttons available

A few screenshots

How to improve this plugin

Source Code

Updates

P.S.

Navigation

Reply to this article

Additional administration buttons in a plugin

Back to the start of the forums

4 Forum messages