mediawiki-extension explore

wikifab/explore

parsers usage :

explore Page :

Navigate to the page 'Spécial:WfExplore' to see the full explore page, _(*1)

explore Query :

'exploreQuery' function just display a list of tutorials, accordint to a semantic query, _(*2)

1st param is the query, the second param (optional) is the number limite of results to display. other named parameters can be set : - sort : field to use to sort results - limit : number of result to display - layout : layout to use (see layout config), _(*3)

Ex : {{#exploreQuery: [[area::Électronique]] | 8}} {{#exploreQuery: [[area::Électronique]] | sort=editdate|limit=8}} {{#exploreQuery: [[area::Électronique]] | sort=editdate|limit=8| layout=event}}, _(*4)

displayExplore function

to display explorer in a page, insert the function displayExplore : {{#displayExplore: params}}, _(*5)

Input Box function

to add an input box to search pages using Special:WfExplore : {{#exploreinputbox:}}, _(*6)

you cant add 2 parameters : the first param is the button text, the second is the placehoder {{#exploreinputbox:GO| placeholder}}, _(*7)

configuration using global vars :

2 vars enable to configure filters params :, _(*8)

$wfexploreCategories = [ $categoriesName => [ CategorisValueName => CategorieValueLabel, ... ], ... ], _(*9)

$wfexploreCategoriesNames = [ 'Type' => 'int:wfexplore-type' , 'area' => 'int:wfexplore-category', 'Difficulty' => 'int:wfexplore-difficulty', 'Cost' => 'int:wfexplore-cost', 'Complete' => 'Complete', ];, _(*10)

Note : using prefix 'int' enable to use translation key, _(*11)

configure layout to display results :

it is possible to change the layout of results, to do it, set the available layouts in LocalSettings.php : $wgExploreResultsLayouts = [ 'event' => DIR . '/views/layout-event.html' ];, _(*12)

then, when calling the explore with parser function in a page, set the 'layout' params : {{#displayExplore: layout=event}}, _(*13)

configure filters for layout

it is possible te define other filter when a layout is given:, _(*14)

$wfexploreCategoriesByLayout = [ 'event' => [ $categoriesName => [ CategorisValueName => CategorieValueLabel, ... ], ... ] ];, _(*15)

Wikifab Groups config

To configure explore for groups like wikifab, here is the config : (it set no filters for groups), _(*16)

$wgExploreResultsLayouts = [ 'group' => DIR . '/extensions/WfextStyle/templates/layout-group-search-result.html' ];, _(*17)

$wfexploreCategoriesByLayout = [ 'group' => [] ];, _(*18)

default sort order

Default sort order can be configured using the $wfeSortField var in LocalSettings.php. For instance, to sort by date of last change : $wfeSortField = 'Modification date';, _(*19)

configuration using hooks :

Explore::OnGetFilters it is possible to change categories using hooks, this is recommended for internationalized wiki., _(*20)

Record hooks in LocalSettings, and set a function, for example :, _(*21)

$wgHooks['Explore::getFilters'][] = 'onExploreGetFilters'; function onExploreGetFilters(& $filters, $layout) { $filters["Type"] = [ ['Oukou'] = 'Oukoukou', ['Ouka'] = 'Oukaka' ]; return true; }, _(*22)