Pour l’appliquer dans un Typo3, il suffit tout simplement d’utiliser les fonctions includeJSFooter pour l’appel des fichiers et footerData pour ajouter n’importe quel script.

Exemple :

page.includeJSFooter {
file1 = fileadmin/template/js/monfichier.js
}

page.footerData {
10 = HTML
10.value (
Mon script
)
}

Ensuite, dans les paramétrages du plugin, il faut lui donner le chemin d’accès du frontend :

Frontend website base path [frontendBasePath]

Base path of the website frontend (e.g. if you call http://mydomain.com/cms/index.php in the browser the base path is « /cms/ »)

Par défaut, ce plugin ne traite que 100 urls à chaque fois qu’il est lancé. Vous pouvez modifier ceci dans les paramétrages du plugin : il faut modifier la valeur du champs « Maximal number of URLs, which can be added to the queue at one time »

ensuite, il faut activer l’indexation dans le typoscript du gabarit principal :

config.index_enable = 1

config.index_externals = 1

Dans les paramétrage du plugin indexed_search engine, il faut désactiver l’indexation à la volée :

Ensuite, il faut créer un utilisateur qui à pour identifiant et mot de passe : _cli_crawler. Il n’y à pas besoin de lui donner les droits administrateur ou de le mettre dans un groupe BE.

Puis, dans le TSconfig de la page racine du site, il faut  mettre :

#set up a crawl for users that arent logged in

Voici une configuration  à mettre dans un gabarit (appelé « solr » par exemple ^^):

dans les constantes :

plugin.tx_solr.solr.host = www.toto.fr => faire des conditions si il y a plusieurs serveurs (dev / val /prod par exemple)

plugin.tx_solr.solr.port = 8080
plugin.tx_solr.solr.scheme = http
plugin.tx_solr.solr.path = /solr/nomdurepertoiresurleserveur/

dans le setup : (certaines lignes sont commentées, à dé-commenter si besoin)

plugin.tx_solr {

addDefaultCss = 1
addDefaultJs = 1

general {
dateFormat.date = d/m/Y
}

index {
enablePageIndexing = 1
enableIndexingWhileBeUserLoggedIn = 1
enableFileIndexingExtractingQuery = 1

additionalFields {
#mytype_sm = TEXT
#mytype_sm.value = {leveltitle:2}
#mytype_sm.insertData= 1
}

// assigns processing instructions to Solr fields during indexing, Solr field = processing instruction
fieldProcessingInstructions {
changed = timestampToIsoDate
created = timestampToIsoDate
endtime = timestampToIsoDate
mytype_sm = pathToHierarchy
}
}

#search {
# TODO: move filter into query{}
#  filter =

#targetPage = 0

#  allowEmptyQuery = 1

#  query {
#   fields = content^40.0, title^5.0, keywords^2.0, tagsH1^5.0, tagsH2H3^3.0, tagsH4H5H6^2.0, tagsInline^1.0

# see http://wiki.apache.org/solr/DisMaxRequestHandler#mm_.28Minimum_.27Should.27_Match.29
#   minimumMatch =

# see http://wiki.apache.org/solr/DisMaxRequestHandler#bf_.28Boost_Functions.29
#  boostFunction =

// TODO implement multiple filters
#      filter {
#        10 = x:y
#        20 = a:b
#      }
# }

form = simple

# TODO make it a top level configuration section
results {
resultsPerPage = 20
resultsPerPageSwitchOptions = 20, 50, 100

#  fieldname => processing instruction, available instructions:  timestamp, utf8Decode, skip (removes the field from the result)
fieldProcessingInstructions {
title = utf8Decode
content = utf8Decode
changed = dateFrench
created = timestamp
indexed = timestamp
# TODO rename the skip instruction to remove?!
spell = skip
}

fieldRenderingInstructions {

# additional example rendering for the title field
title2 = TEXT
title2 {
field = title
case = upper
wrap = <span class= »title »>|</span>
}

url = TEXT
url {
field = url
htmlSpecialChars = 1
htmlSpecialChars.preserveEntities = 1
}

}

pagebrowser {
# TODO move to top level templateFile options
#templateFile = fileadmin/templates/extensions/pagebrowse/template.html
}

ignorePageBrowser = 0
}

highlighting = 1
highlighting {
# title and content are set as default in solrconfig.xml already
#      highlightFields = title,content
fragmentSize = 500

wrap = <span class= »results-highlight »>|</span>
}

spellchecking = 1
spellchecking {
wrap = |<div class= »spelling-suggestions »>###LLL:didYouMean### |</div>|
}

sorting = 1
sorting {
defaultOrder = asc

fields {
relevancy = 1
relevancy {
label = sorting_relevancy
}

sortTitle = 1
sortTitle {
label = sorting_title
}

type = 1
type {
label = sorting_type
}

sortAuthor = 0
sortAuthor {
label = sorting_author
}

created = 1
created {
label = sorting_created
}
}
}

faceting = 1
faceting {
minimumCount = 1
sortBy = count
limit = 10
singleFacetMode = 1

facetOrder = type, author, myType
facets {
type {
label = Type de document
field = type
missing = 0
}

author {
label = Auteur
field = sortAuthor
}
myType {
label = Rubrique
field = mytype_sm
}

/* Not implemented yet
lastChanged {
label = Last Changed
date =
}

feuser {
label = Created by FE User
query =

TODO
renderingInstruction = TEXT
renderingInstruction {
wrap = <span>|</span>
insertData = 1
}

}
*/
}

// available place holders: @facetValue, @facetName, @facetText
removeFacetLinkText = @facetText (Supprimer)

showAllLink.wrap = <li>|</li>
}
}

suggest = 1
suggest {
loadJQuery = 1

numberOfSuggestions = 10
suggestField = spell
forceHttps = 0

stylesheet = EXT:solr/resources/css/jquery-ui/jquery-ui-1.8.2.custom.css

javaScriptFiles {
library  = EXT:solr/resources/javascript/jquery-1.4.2.min.js
ui    = EXT:solr/resources/javascript/jquery-ui-1.8.2.custom.min.js
suggest  = EXT:solr/resources/javascript/eid_suggest/suggest.js
}
}

// TODO move to search.results
searchResultsViewComponents {
faceting = 1
sorting = 1
}

viewhelpers {
crop {
maxLength = 30
cropIndicator = …
}
}

logging {
exceptions = 1

// TODO change « indexing » to enable all indexing logging, split up into several options
indexing = 1
indexing{
indexQueuePageIndexerGetData = 1
}

query {
filters = 1
searchWords = 1
queryString = 1
rawPost = 1
rawGet = 1
}

}

Ensuite :

ne pas oublier d’appeler ce TS dans le gabarit principal de votre typo3 puis d’inclure les gabarits statiques de l’extension :

apache solr et pagebrowse.

Tout est (très bien) expliqué sur le blog de Thomas Leroy (intégrateur certifié TYPO3) :
http://www.tleroy.fr/creer-plusieurs-flux-rss-tt_news/ 

A vous de jouer !

Le code TypoScript ci-dessous présume que vous avez fait une configuration de base pour que typo3 aille chercher votre template, dans lequel vous avez placé un marqueur ###monsommaire### et que le champ « Titre » de chacun des contenus de votre page TYPO3 est rempli

La particularité de ce code est qu’il va tester le nombre de contenus dans la page.

• Si il n’y aucun contenu ou un seul contenu, le sommaire ne s’affichera pas (car pas vraiment utile et pas très esthétique dans ce cas).
• Si il y a deux contenus ou plus, le sommaire sera affiché à l’endroit où vous avez placé votre marqueur dans votre template.

Code TypoScript

marks.monsommaire = CONTENT
marks.monsommaire {
   //je récupère le titre et l'id de chacun des contenus de la colonne "normal" de ma page TYPO3
   table = tt_content
   select {
      pidInList = this
      orderBy = sorting
      selectFields = header,uid
      where = colPos = 0
      languageField=sys_language_uid
   }

   //je teste le nombre de contenus de ma colonne normal
   stdWrap.if.value = 1
   stdWrap.if.isGreaterThan.numRows.table = tt_content
   stdWrap.if.isGreaterThan.numRows.select {
      pidInList = this
      where = colPos = 0
      languageField=sys_language_uid
   }
   //si le nombre de contenus de ma page est supérieur à 1, j'affiche le sommaire ancré sous forme de listes à puces
   stdWrap.wrap = <ul class="ss_menu_page"><a name="sommaire_page"></a>|</ul>
   stdWrap.required = 1
   renderObj = TEXT
   renderObj {
      field = header
      required = 1
      dataWrap= <li><a href="#c{field:uid}" title="#c{field:uid}" target="_self">|</a></li>
   }
}

Exemple

http://eduscol.education.fr/histoire-geographie/enseigner/ressources-par-niveau-et-programmes/college/sixieme/histoire.html

Et aussi…

Toujours dans le cas d’une page longue, il peut être utile de rajouter un lien ancré « Retour en haut de page » sous chacun des contenus typo3 de la page.
Pour ce faire, voir l’article [TypoScript] Ajouter automatiquement un lien ancre #top sous chaque contenu d’une page TYPO3

Le code TypoScript ci-dessous présume que vous avez fait une configuration de base pour que typo3 aille chercher votre template, dans lequel vous avez placé un marqueur ###monmarqueur### et un <a name= »#top »></a> à ce qui correspond à votre haut de page (ou haut de contenu).

La particularité de ce code est qu’il va tester le nombre de contenus dans la page.

• Si il n’y aucun contenu ou un seul contenu, le lien « Remonter en haut de page » ne s’affichera pas (car pas vraiment utile et pas très esthétique dans ce cas).
• Si il y a deux contenus ou plus, le lien « Remonter en haut de page » sera affiché sous chacun des contenus de la page.

Code TypoScript

//le marqueur "monmarqueur" va aller chercher le contenu de la colonne de contenu "normal"
marks.monmarqueur = CONTENT
marks.monmarqueur < styles.content.get
marks.monmarqueur{
   stdWrap.required = 1

   //on prepare un tableau d objet (au cas ou ca n est pas deja cree ailleurs)
   renderObj.stdWrap.append=COA

   //on cree un objet qui sera ajoute apres le contenu normal
   renderObj.stdWrap.append.30=TEXT

   //on y met le code HTML qui sera utilise
   renderObj.stdWrap.append.30.value= <a href="#top" title="Revenir en haut de page">Revenir en haut de page</a>

   //on parametre le .stdWrap.if qui va du coup agir uniquement sur l objet .append.30
   //on met en place la valeur maximal pour le if
   renderObj.stdWrap.append.30.stdWrap.if.value = 1

   //on met en place le isGreaterThan qui teste si il y a + d'un contenu dans la page
   renderObj.stdWrap.append.30.stdWrap.if{
      isGreaterThan.numRows.table = tt_content
      isGreaterThan.numRows.select.pidInList = this
      isGreaterThan.numRows.select.where = colPos = 0
   }
}

Exemple

http://eduscol.education.fr/histoire-geographie/enseigner/ressources-par-niveau-et-programmes/college/sixieme/histoire.html

Remerciements

Tout le mérite de ce script TS revient à « OlivierSC  », développeur/intégrateur TYPO3 certifié, et membre fidèle du Forum FR Typo3.

Relire la discussion à l’origine de cet article.

Dans ce cas, les balises HTML restent non fermées et s’appliquent donc à tout le contenu qui se trouver après votre actualité dans votre page, ce qui peut s’avérer un peu gênant.

Pour y remédier, deux petites choses à faire :

1. Installer l’extension PMK HTML Crop, qui va vous permettre d’utiliser une nouvelle fonction « htmlCrop » dont les propriétés sont les mêmes que celle de la fonction « crop », en prenant toutefois en compte les tags HTML de votre contenu.
2. Placer ces deux lignes de code TS dans votre template principal

plugin.tt_news.general_stdWrap.postUserFunc = tx_pmkhtmlcrop->htmlCrop
plugin.tt_news.displayLatest.content_stdWrap.htmlCrop = 100|...|1

Bien évidemment, tronquer au nombre de caractères que vous le souhaitez (ici 100) et remplacer displayLatest par displayList en fonction de vos besoins.

Pour pallier ce problème, il suffit d’ajouter ce bout de code à la config TS du groupe d’utilisateur (ou directement de l’utilisateur si besoin) :

options.useListOfAllowedItems = 0

Pensez à enregistrer et surtout vider les caches TYPO3.

Pour ce faire, il va falloir ajouter un peu de TYPOSCRIPT à votre template TYPO3. Je vous mets le code en brut ci-dessous, avec un brève explication en-dessous.

temp.lastUpdate = TEXT
temp.lastUpdate {
data = page:crdate
if.isTrue.data = page:crdate
strftime = %d/%m/%Y
data = register : SYS_LASTCHANGED
if
}

page.10 {
marks.last_update < temp.lastUpdate
marks.last_update.wrap = <p class="date_maj">Page mise &agrave; jour le&nbsp;|.</p>
}

En gros :

• On définit une variable temporaire (de type TEXT) dans laquelle on va récupérer la date de création de la page (crdate) ;
• On regarde ensuite si dans la base de données a été enregistrée une date de mise à jour de la page (register : SYS_LASTCHANGED), normalement plus récente que la date de création… . Si c’est le cas, notre variable temporaire prend comme valeur la date de mise à jour ;
• Ensuite (en supposant que les marqueurs de template TYPO3 n’ont plus de secret pour vous), je vais donner à mon marqueur TYPO3 (last_update) la valeur de la variable définie plus haut ;
• Je fais un petit « wrap » pour la mise en forme, parce qu’avec ce « wrap » et un petit coup de CSS, ça sera plus joli et surtout ça collera à votre charte ;
• Si comme moi, vous avez créé un nouveau gabarit TS juste pour ce bout de code (oui…j’aime bien découper tous mes TS pour savoir à quoi ils correspondent et pour pouvoir les modifier plus facilement), n’oubliez pas de l’inclure dans votre template général.

Et voilà, c’est fait.

Si vous avez des questions, n’hésitez pas à les poser via le commentaire c’est fait pour ça !

Ce tuto nécessite un site TYPO3 à disposition qui ne craint rien (un TYPO3 de test ou en local fera très bien l’affaire), une bonne maîtrise de TYPO3 et du typoscript, de l’extension tt_news, et un peu de connaissance en php (mais vraiment pas beaucoup, on s’en sort avec du copier-coller et quelques neurones).

L’extension Kickstarter

Pour créer un champ supplémentaire dans vos news, pas de miracle, il faut en fait créer une extension : un « hook », c’est une extension d’extension. Et pour en créer une, il est plus facile de commencer avec le Kickstarter :  l’extension qui aide à faire des petits (mais qui ne les fait pas à votre place).

Le Kickstarter n’est pas un éditeur de code ni une machine à créer l’extension-de-vos-rêves sans écrire une ligne de code, elle permet juste de créer l’architecture des fichiers nécessaires à une extension. Et c’est déjà pas mal.

Donc on ouvre le gestionnaire d’extension de son TYPO3 de test et on installe le kickstarter.

Nommer et décrire votre extension

Une fois le Kickstarter installé, dans le gestionnaire d’extensions, choisissez « make new extension » dans le menu déroulant du haut.

Ensuite, paramétrez les éléments suivants pour votre extension : la clé de votre extension, son titre, une petite description, sa catégorie (dans notre cas: frontend plugin), ses dépendances (ici : tt_news), votre nom et votre mail.

Je vais un peu vite: si vous voulez en savoir plus sur cette page de paramétrages, vous pouvez consulter le tuto très bien fait sur typo3journal.

Pour terminer, cliquez sur « update » (l’un ou l’autre des deux boutons).

Ajouter une table à tt_news

Pour ajouter un champ à tt_news, commençons par étendre sa base de données avec une table.

1. Cliquez sur « Extend existing tables ».
2. Dans la liste qui s’affiche, choisissez News (tt_news).
3. Donnez un nom à votre champ puis un titre. Le titre est ce qui s’affichera dans le back office donc n’hésitez pas à être un peu descriptif.
4. Choisissez le type de champ. Vous pouvez visualiser en cliquant sur « update » et changer ensuite si ça ne vous convient pas.
5. Pour notre exemple, j’ai choisi un champ simple de type «String input».

De ce choix de champ dépendra ensuite le code à créer pour interpréter les données intégrées.
Vous pouvez ajouter autant de champs que vous le souhaitez, il vous suffit de cliquer sur « update » et de remplir les champs en dessous « New Field ».

À cette étape, on en a presque terminé avec le kickstarter. Si vous voulez aller plus loin à son propos, n’hésitez pas à consulter le tuto sur typo3journal.

Générer les fichiers de l’extension

Toujours dans le kickstarter :

1. Cliquez sur « View result » sous la clé de votre extension, puis sur « write ». Vous remarquerez le chemin d’accès aux fichiers de votre extension (typo3conf/ext/nom_de_mon_extension/).
2. Un message apparaît, informant que le kicksarter n’est pas un éditeur et que si l’extension existe déjà sur votre site les fichiers précédents seront écrasés. Cliquez sur ok.
3. Un bel encart vert vous indique que l’extension existe mais qu’elle n’est pas installée : ne l’installez pas pour le moment, ça ne sert à rien.
4. Si vous allez dans le gestionnaire des extensions, vous verrez votre petite nouvelle dans la liste des extension non installées.

Récupérer les fichiers générés

Pour la suite, vous aurez peut-être besoin de mon extension créée dans cet exemple : je vous invite à la télécharger et à l’installer dans votre TYPO3 de test.

Ensuite, lâchez un peu le back de TYPO3 et ouvrez votre éditeur de code préféré : vous allez avoir besoin d’un éditeur de code et d’un moyen de transfert ftp si vous n’êtes pas en local. Personnellement j’utilise Netbeans qui fait les deux, comme beaucoup d’autre IDE, vous faites comme vous voulez : chacun sa came.

Récupérez les fichiers de votre extension, ils se trouvent au même endroit que toutes les extensions, dans un dossier au nom de votre extension : typo3conf/ext/nom_devotreextension.

Profitez-en pour récupérer aussi les fichiers de l’exemple : typo3conf/ext/test_newsplus.

Création des fichiers supplémentaires

1. Nous allons commencer par créer un fichier php qui va servir à stocker le code qui va étendre tt_news : class.tx_nomdemonextension.php. Pour le moment, laissons ce fichier vide.
2. Attention au nommage, c’est très important. Vous noterez bien que le nom du fichier est constitué de « class. » puis « tx_ » puis de la clé de votre extension sans les underscore s’il y en a.
3. Ensuite, nous créons le fichier qui va ajouter notre extension à tt_news : ext_localconf.php (attention à bien le nommer comme il faut). Laissez ce fichier vide pour le moment.
4. On va aussi créer un fichier pour paramétrer le setup. Pour mon exemple j’ai juste besoin d’un « wrap » équivalent à « title_stdWrap » dans tt_news. Je vais créer un fichier qui servira d’exemple de paramétrage aux utilisateurs de l’extension : dans un dossier « static », ajouter un fichier setup.txt.

Voilà à quoi doit ressembler l’arbre de votre extension à la fin de cette étape :

Le fichier « ext_localconf.php »

1. Ouvrez le fichier puis copier-collez les lignes suivantes:

   <?php
   if (!defined ('TYPO3_MODE')) {
    die ('Access denied.');
   }
   // include "model"
   require_once(t3lib_extMgm::extPath('test_newsplus').'class.tx_testnewsplus.php');
   // call tt_news Hook
   $TYPO3_CONF_VARS['EXTCONF']['tt_news']['extraItemMarkerHook'][] = 'tx_testnewsplus';
   ?>

2. Les lignes surlignées contiennent des éléments que vous devez remplacer : clé de votre extensions, chemin vers le fichier class.nomdemonextension.php, nom de votre extension.

Le fichier « class.tx_nomdemonextension.php »

1. Ouvrez celui de l’exemple en parallèle : class.tx_testnewsplus.php, et copiez-collez l’intégralité de ce fichier dans le vôtre. Nous allons le modifier pour l’adapter.
2. Les entêtes en commentaires sont des protections légales, cherchez et remplacez par vos propre nom, mail et nom d’extension.
3. Intéressons-nous maintenant à la class php du fichier :

   class tx_testnewsplus {
    function extraItemMarkerProcessor($markerArray, $row, $lConf, $parentObject) {
    if ($row['tx_testnewsplus_producteur'] != ''){
    $markerArray['###NEWS_PRODUCTEUR###'] = $parentObject->local_cObj->stdWrap($row['tx_testnewsplus_producteur'], $lConf['producteur_stdWrap.']);}
    else $markerArray['###NEWS_PRODUCTEUR###'] = "";
    return $markerArray;
    }
   }
   if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/test_newsplus/class.tx_testnewsplus.php'])
    include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/test_newsplus/class.tx_testnewsplus.php']);
   ?>

   En clair, cette fonction dit que : s’il y a des choses inscrites dans le champ «  tx_testnewsplus_producteur » alors il faut les mettre à la place du marqueur ###NEWS_PRODUCTEUR###.
   Et si dans le setup on a ajouté un paramètre qui s’appelle producteur_stdWrap, alors on l’ajoute au marqueur.
   Enfin, s’il n’y a rien dans le champ  tx_testnewsplus_producteur, alors il n’y a rien qui s’affiche.
   Voilà il ne vous reste plus qu’à modifier avec vos propres nom de fichiers et de champs -  les lignes concernées sont surlignées dans le code ci-dessus.
   Si vous avez créer plusieurs champs, dupliquez les lignes 3,4,5 avant la ligne 6, et adaptez à chaque nom de champ et de marqueur, pensez aussi à modifier le stdWrap à chaque fois.

4. Pensez bien à ajoutez votre nouveau marqueur dans votre template tt_news.

Si vous souhaitez aller plus loin dans les fonctions de hook de tt_news, la doc de tt_news amène quelques infos et il y a des exemples directement dans les fichiers de l’extension tt_news (typo3conf/ext/tt_news/res/ tous les fichiers commençant par example_)

Le fichier « setup.text » (dossier static)

Ce fichier est informatif : il va indiquer le setup possible pour mon nouveau champ tt_news.

Dans mon exemple, j’ai besoin de pouvoir entourer le nom de producteur récupéré par un intitulé du type « producteur : ». On va ajouter donc utiliser le « producteur_stdWrap » placé dans le fichier « class.tx_testnewsplus.php », qui aura la même fonction « author_stdWrap » ou « title_stdWrap » dans le setup de tt_news.

Donc ajouter dans « setup.txt » :

plugin.tt_news.displaySingle.producteur_stdWrap.wrap = <p>Producteur : |</p>

plugin.tt_news.displayList.producteur_stdWrap.wrap = <p>Producteur : |</p>

plugin.tt_news.displayLatest.producteur_stdWrap.wrap = <p>Producteur : |</p>

Cette ligne sera ensuite à ajouter dans le gabarit setup de tt_news.

Installer et tester votre nouveau champ TT_News

Il ne vous reste plus qu’à uploader les fichiers de votre extensions, ainsi que le template de tt_news où vous avez ajouté le nouveau marqueur.
Une fois cela fait, rendez-vous dans le gestionnaire d’extension de votre back typo3 pour installer l’extension.

À l’installation, il vous demande la création du nouveau champ : oui bien sûr que vous êtes d’accord, c’est même exprès pour ça que je fait ce tuto.

Ensuite, insérez une news ou ouvrez une ancienne news, vous devrez y voir, dans l’onglet «Etendues » ou « Extended », votre nouveau champ personnalisé.

Si vous souhaitez paramétrer le Wrap, il ne vous reste plus qu’à ajouter dans le setup les éléments du point 10.

Et voilà, c’est fini pour aujourd’hui.