AlphaContent

Présentation: AlphaContent est un composant qui permet de créer des annuaires de type Yahoo à partir des sections et catégories de votre site Joomla!. Il permet également d'ajouter les articles non catégorisés (articles statiques) comme une section à l'instar des composants weblinks et contact. AlphaContent possède son propre système de vote en ajax qui peut être utilisé en remplacement du système de vote natif.

Licence: AlphaContent version 4.x est réalisé sous licence Donationware. Tous droits réservés.

Installation : Installer le composant via l'interface d'administration de Joomla. Lors de l'installation, le plugin s'installe et est publié automatiquement. Si toutefois le répertoire Plugins n'a pas les droits en écriture, une erreur survient et arverti l'utilisateur. Le composant devra être réinstallé après modifications des droits sur le répertoire Plugins.

Mise en route :

Etape 1 - Paramétrage
Via le panneau d'administration, cliquez sur le composant AlphaContent puis paramétrez la configuration générale du composant.

Général : cet ensemble de paramètres détermine les principaux paramètres pour l'affichage du listing des résultats.
- Page d'accueil du composant permet d'afficher une liste de résultat au choix entre les sections de contenu, les articles statiques, la section Weblink, la section contacts ou une liste d'articles choisis, ou bien de rien afficher du tout.
- Items ID: indiquez les ID des articles si vous avez sélectionné l'option Sélection manuelle au dessus.
- Nombre de colonnes: Vous pouvez afficher votre liste de résultats sur 1 ou 2 colonnes.
- Style intro : possibilité entre pas d'intro, une intro texte uniquement (sans balise html) ou l'intro originale de l'article avec les plugins associés.
- Nombre maxi de caractères: si vous avez sélectionné intro texte, vous pouvez limiter le nombre de caractère à l'affichage.
- Titre cliquable : oui ou non.
- Numéro d'index : affiche une numérotation devant chaque article du listing.
- Icône Nouveau : affiche une icône "Nouveau" à la suite du titre de l'article.
- Nombre de jours: saisissez le nombre de jours durant lequel l'icône "Nouveau" doit apparaître.
- Icône Hot : affiche une icône "Hot" à la suite du titre de l'article.
- Nombre de hits : indiquez le nombre de hits déterminant l'affichage de l'icône "Hot".
- Date de l'article : affichez ou non la date de l'article ou la date de modification.
- Format date : sélection du format d'affichage de la date.
- Auteur article : affichez ou non l'auteur de l'article.
- Section/Catégorie : affichez le nom de la section et de la catégorie de l'article.
- Hits : Affichez ou non le nombre de hits concernant l'article. (désactivé pour la section contacts)
- Nombre de commentaires: affichez ou non le nombre de commentaires concernant l'article.
- Système de commentaire: sélectionnez le système de commentaire servant à afficher le nombre d ecommentaires.
- Imprimer : affiche un lien "imprimer" dans le listing.
- PDF : affiche un lien "PDF" dans le listing.
- Signaler : affiche un lien rapporter/signaler cet article à l'administrateur
- Email : affiche un lien "envoyer" dans le listing.
- Lire la suite : affiche un lien "lire la suite" dans le listing si l'option intro texte est activé et que le texte a été tronqué ou si l'article possède naturellement une suite.
- Lien Plan : Affiche un lien vers Google Maps (voir plus bas).
- Nombre de pages: affiche le nombre de page sur le total de pages existantes.
- Nombre de résultats par page : Sélectionnez le nombre d'articles à afficher par page.
- Recherche : affiche une boite de saisie pour les recherches.
- Bouton recherche : affiche un bouton après la boite de saisie.
- Ordre des résultats: sélectionnez l'ordre par défaut des résultats du listing.
- Image article : affiche ou non la première ou la dernière image contentue dans un article.
- Position image : sélectionnez à gauche du listing, à droite du listing ou alterné.
- Dimension de l'image: saisissez le nombre maxi en pixel de l'image affichée.

Google Maps : cet ensemble de paramètres permet d'utiliser les fonction intégrées à AlphaContent pour afficher un lien "carte" ou "plan" au moyen de l'API google Maps.
- Niveau de Zoom : Entrez un niveau de zoom pour l'affichage de la carte.
- Largeur de la carte : entrez un nombre en pixels pour déterminer la largeur de la fenêtre Google Maps.
- Hauteur de la carte : entrez un nombre en pixels pour déterminer la hauteur de la fenêtre Google Maps.
- types : afficher les types de cartes disponibles (carte, satellite, hybride) dans la fenêtre Google Maps.
- Contrôles : afficher les outils de navigation dans la fenêtre Google Maps.

Comment utiliser le plugin Google Maps ?
Pour créer un lien vers Google Maps, vous devez saisir le tag suivant dans votre article: {ALPHAGMAP=longitude|latitude|marker text}. Latitude et longitude sont numériques et marker est le message texte de votre position dans la carte (le code HTML est supporté mais pas les apostrophes). Exemple pour Paris: {ALPHAGMAP=48.85667|2.35099|Paris!}

Système de vote en Ajax :
Cet ensemble de paramètres permet d'utiliser le système de vote intégré à AlphaContent.
- Utilisez le système de vote : oui ou non.
- Nombre d'"étoiles" à afficher.
- Largeur de l'étoile : Si vous choisissez de modifier cette dimension dans le cas où vous souhaitez utiliser votre propre image pour le vote, pensez également à modifier le fichier CSS (rating.css) situé dans components/com_alphacontent/assets/css/ et remplacer l'image de vote dans components/com_alphacontent/assets/images/starrating.gif. La valeur par défaut est de 16 pixels.

Problèmes avec le système de vote en Ajax :
Si votre site est en local ou sur un serveur distant mais dans un sous-répertoire (Site non situé à la racine mais dans un répertoire de votre domaine ou sous-domaine), il se peut que la barre de vote fonctionne mal. Il suffit juste d'éditer le fichier nommé rating.js situé dans <votre site>/components/com_alphacontent/assets/js.
Chercher les lignes suivantes (line 67):

var myDomain = '';

if ( document.domain!='localhost' ) {
        myDomain = /(http?:\/\/[^\/]+)/.exec(window.location.href)[1] + '/';
}

et modifier comme ceci:

var myDomain = 'your url'; // exemple : var myDomain = 'http://www.xxxxxxx.com/xxxxx/' ou var myDomain = 'http://localhost/xxxxxx/'

/*
if ( document.domain!='localhost' ) {
        myDomain = /(http?:\/\/[^\/]+)/.exec(window.location.href)[1] + '/';
}
*/

Notes : Dans le cas ou vous souhaitez utiliser également le système de vote en dehors du cadre de l'utilisaton d'AlphaContent il est nécessaire d'éditer les paramètres du plugin alphacontent et positionner à "enabled".

Sharethis Widget: cet ensemble de paramètres permet d'utiliser le widget de Sharethis . Vous pouvez créer votre widget personnel sur http://sharethis.com/publisher?type=stapi#configurator. Il suffit juste de vous inscrire auparavant puis paramétrer votre widget pour obtenir son code.
-- Utilisez Sharethis : oui ou non.
-- Sharethis widget code: Coller votre code Sharethis dans cette zone de texte.

Notes : Dans le cas ou vous souhaitez utiliser également le widget Sharethis en dehors du cadre de l'utilisaton d'AlphaContent il est nécessaire d'éditer les paramètres du plugin alphacontent et positionner à "enabled".

Etape 2 - Création du menu
Créez un menu lié au composant AlphaContent via le panneau d'administration de Joomla. Puis éditez les paramètres spécifiques pour ce menu.

Dans la partie paramètre de base, vous trouverez tous les paramètres nécessaire à la création du répertoire, choix des sections etc...
Dans la partie avancée, vous avez la possibilité d'ajouter des fonctionnalité au répertoire telles que l'affichage de l'image des sections et catégories, taille de l'image ainsi que la possibilité d'ajouter une image aux sections weblinks, contacts et articles statiques.

Vous pouvez également ajouter une nouvelle barre d'index alphabétique en dessous de la première en ajoutant le tag <br/> ou <br /> séparé par une virgule ,
exemple pour un alphabet russe suivi de l'occidental : А,Б,В,Г,Д,Е,Ж,З,И,К,Л,М,Н,О,П,Р,С,Т,У,Ф,Х,Ц,Ч,Ш,Щ,Э,Ю,Я,<br />,A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z

- Articles relatifs : vous pouvez afficher à la suite de l'article un certain nombre d'article ayant les mêmes mots clé que l'article sélectionné.
- Nombre d'articles : indiquez le nombre d'articles relatifs à afficher à la fin de l'article en cours.

- Tags : Vous pouvez avec cette option afficher une liste de tags au-dessus de l'article. Chaque tag affiché permet de lancer une recherche dans les articles ayant le même tag.
- Nombre de tag à afficher : indiquez le nombre de tags à afficher.

- Système de vote : activez ou non le système de vote pour ce répertoire.
- Sélection du système de vote : Vous avez le choix entre le système natif de Joomla ou bien le système de vote en Ajax d'AlphaContent.

Dans la partie composant, vous retrouvez tous les paramètres de base saisis dans l'administration du composant. Chaque menu peut être paramétré différemment et permet de publier ainsi plusieurs annuaires distincts.