URLs

Please note: This page is under construction and has not been finished yet.
Introduction
You can generate a Search Engine Friendly (SEF) URLs using the following method:
e107::url($plugin, $key, $row, $options);
Parameter
Type
Description
Mandatory?
plugin
string
Folder name of the plugin. (will use data from e_url.php)
Yes
key
string
Unique key
Yes
row
array
Array of variable data such as id, title etc. eg. user_id, user_name
No
options
array
An associative array of additional options, with the following elements:
mode: abs | full (returning the absolute path or full URL)
query: an array of query key/value-pairs (without any URL-encoding) to append to the URL.
fragment: a fragment identifier (named anchor) to append to the URL. Do not include the leading '#' character.
(optional)
No
Examples
Example 1: Forum topic URLs
In this example we will generate search-engine-friendly URLs for a forum topic with the following code: .
// these values are usually loaded from the database. 
$data = array(
	'forum_sef'		=>	'my-sef-forum-name', 
	'thread_id'		=>  2, 
	'thread_sef'	=>	'my-forum-topic'
); 
​
$url = e107::url('forum','topic', $data);
The code above loads the following file: e107_plugins/forum/e_url.php and generates a URL from the following array data with the unique key topic:
$config['topic'] = array(
	'regex'    => '^forum/(.*)/(d*)-([w-]*)/???(.*)',
	'sef'      => 'forum/{forum_sef}/{thread_id}-{thread_sef}/',
	'redirect' => '/e107_plugins/forum/forum_viewtopic.php?id=$2'
 );
Only the value of 'sef' is used in this array. it substitutes the values {forum_sef}, {thread_id} and {thread_sef} with the variables in the $data array.
The end result would look something like this: http://sitename.com/forum/my-sef-forum-name/2-my-forum-topic​
Example 2: Using optional parameters
TODO: Add examples using the options parameter

Parameter	Type	Description	Mandatory?
plugin	string	Folder name of the plugin. (will use data from e_url.php)	Yes
key	string	Unique key	Yes
row	array	Array of variable data such as id, title etc. eg. user_id, user_name	No
options	array	An associative array of additional options, with the following elements: mode: abs \| full (returning the absolute path or full URL) query: an array of query key/value-pairs (without any URL-encoding) to append to the URL. fragment: a fragment identifier (named anchor) to append to the URL. Do not include the leading '#' character. (optional)	No

Last modified 7mo ago