> For the complete documentation index, see [llms.txt](https://devguide.e107.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devguide.e107.org/classes-and-methods/preferences.md).

# Preferences

{% hint style="danger" %}
**Please note:** This page is under construction and has not been finished yet.
{% endhint %}

### Introduction

Use the following to retrieve the render class object. 

```php
$pref = e107::getPref();
```

### Retrieving preferences

Developers may retrieve admin preferences for their theme or plugin, or a core preference using the following method:

```php
e107::pref(type, value);
```

*Example: Load a stored value that was saved in the preferences admin area of the 'faqs' plugin*

```php
$faqPrefs = e107::pref('faqs'); // returns an array.
```

Or load a single preference value.

```php
$FaqPerPage = e107::pref('faqs', 'faqs_per_page');
```

| Type                     | Value (optional)                                       |
| ------------------------ | ------------------------------------------------------ |
| core                     | all core preference values.                            |
| theme                    | preferences of the currently selected front-end theme. |
| (any plugin folder name) | preferences of a particular plugin                     |