jPref est en fait une classe qui encapsule jKVDb. Par conséquent, pour utiliser jPref il vous suffit de définir un profil pour jkvdb ayant comme nom jpref.

Dans votre profiles.ini.php:

[jkvdb:jpref]
...

Pour plus de détails sur la configuration de ce driver, voir la documentation de jKVDb.

• jPref::get($key) : pour récupérer une préference.
• jPref::set($key, $value) : pour enregistrer ou modifier une préférence.

Exemple :

jPref::set('nb.items.per.page', 20);

$val = jPref::get('nb.items.per.page');
// $val contient 20

Dans votre fichier preferences.ini.php, vous avez une section pour chaque preference, dont le nom commence par "pref:" :

[pref:nom.systeme.de.la.pref]
; "string" | "integer" | "boolean" | "decimal" (défaut string)
type =
; clé de la locale pour le libellé
locale =
; identifiant du groupe auquelle appartient la préférence
group =
; sujet jAcl2 correspondant au droit de lecture de la préférence
read_acl_subject =
; sujet jAcl2 correspondant au droit d'écriture de la préférence
write_acl_subject =
; valeur par défaut
default_value =

Note : chaque parametre est optionel.

read_acl_subject et write_acl_subject permette de limiter l'accés aux préférences en fonction des utilisateurs. Certaines preferences peuvent par exemple n'être accessible et modifiable que par des administrateurs par exemple. Il vous faudra donc définir des droits dans jAcl2, et indiquer ici les "sujets" correspondant.

Si read_acl_subject et write_acl_subject ne sont pas rempli, tout utilisateur qui a le droit "jprefs.prefs.list" peut lire et modifier la préférence.

Les préferences peuvent être regroupées, afin d'en faciliter la gestion. Vous pouvez avoir un groupe par module ou domaine fonctionnel par exemple.

Dans votre fichier preferences.ini.php, déclarez une section avec un prefix "group:". Une section contient le label du groupe et son ordre d'affichage.

[group:nom.syteme.de.la.pref]
; clé de la locale définissant le label du groupe
locale =
; ordre d'affichage dans la liste des préférences
order =

Note : chaque paramètre est optionel et peut ne pas être remplie.

[group:contact]
locale = "contact~admin.pref.group.contact"
order = 1

[pref:telephone]
type = string
locale = "contact~admin.pref.telephone"
group = "contact"
read_acl_subject =
write_acl_subject = "contact.edit.infos"
default_value =


[group:shop]
locale = "contact~admin.pref.group.contact"
order = 2

[pref:nb.items.per.page]
type = integer
locale = "shop_admin~admin.pref.nb.items.per.page"
group = shop
read_acl_subject =
write_acl_subject =
default_value = 15

[pref:shop.is.open]
type = boolean
locale = "shop_admin~admin.pref.shop.is.open"
group = shop
read_acl_subject =
write_acl_subject = "shop.edit.shop.status"
default_value = "false"