From 5a33293b5c830be12f4c29bb3605d6112222e31a Mon Sep 17 00:00:00 2001 From: Derek Allard Date: Fri, 14 Dec 2007 22:57:22 +0000 Subject: Fixed an example of accept_charset() in the User Agent Library. --- user_guide/libraries/user_agent.html | 202 +---------------------------------- 1 file changed, 1 insertion(+), 201 deletions(-) (limited to 'user_guide/libraries') diff --git a/user_guide/libraries/user_agent.html b/user_guide/libraries/user_agent.html index 6b54fcdbe..7dc747ef6 100644 --- a/user_guide/libraries/user_agent.html +++ b/user_guide/libraries/user_agent.html @@ -1,201 +1 @@ - - - - -CodeIgniter User Guide : User Agent Class - - - - - - - - - - - - - - - - - - - - - - -
- - - - - -

CodeIgniter User Guide Version 1.5.4

-
- - - - - - - - - -
- - -
- - - -
- - -

User Agent Class

- -

The User Agent Class provides functions that help identify information about the browser, mobile device, or robot visiting your site. -In addition you can get referrer information as well as language and supported character-set information.

- -

Initializing the Class

- -

Like most other classes in CodeIgniter, the User Agent class is initialized in your controller using the $this->load->library function:

- -$this->load->library('user_agent'); -

Once loaded, the object will be available using: $this->agent

- -

User Agent Definitions

- -

The user agent name definitions are located in a config file located at: application/config/user_agents.php. You may add items to the -various user agent arrays if needed.

- -

Example

- -

When the User Agent class is initialized it will attempt to determine whether the user agent browsing your site is -a web browser, a mobile device, or a robot. It will also gather the platform information if it is available.

- - - -$this->load->library('user_agent');
-
-if ($this->agent->is_browser())
-{
-    $agent = $this->agent->browser().' '.$this->agent->version();
-}
-elseif ($this->agent->is_robot())
-{
-    $agent = $this->agent->robot();
-}
-elseif ($this->agent->is_mobile())
-{
-    $agent = $this->agent->mobile();
-}
-else
-{
-    $agent = 'Unidentified User Agent';
-}
-
-echo $agent;
-
-echo $this->agent->platform(); // Platform info (Windows, Linux, Mac, etc.) - - - -

Function Reference

- - -

$this->agent->is_browser()

-

Returns TRUE/FALSE (boolean) if the user agent is a known web browser.

- -

$this->agent->is_mobile()

-

Returns TRUE/FALSE (boolean) if the user agent is a known mobile device.

- -

$this->agent->is_robot()

-

Returns TRUE/FALSE (boolean) if the user agent is a known robot.

- -

Note:  The user agent library only contains the most common robot -definitions. It is not a complete list of bots. There are hundreds of them so searching for each one would not be -very efficient. If you find that some bots that commonly visit your site are missing from the list you can add them to your -application/config/user_agents.php file.

- -

$this->agent->is_referral()

-

Returns TRUE/FALSE (boolean) if the user agent was referred from another site.

- - -

$this->agent->browser()

-

Returns a string containing the name of the web browser viewing your site.

- -

$this->agent->version()

-

Returns a string containing the version number of the web browser viewing your site.

- -

$this->agent->mobile()

-

Returns a string containing the name of the mobile device viewing your site.

- -

$this->agent->robot()

-

Returns a string containing the name of the robot viewing your site.

- -

$this->agent->platform()

-

Returns a string containing the platform viewing your site (Linux, Windows, OS X, etc.).

- -

$this->agent->referrer()

-

The referrer, if the user agent was referred from another site. Typically you'll test for this as follows:

- - if ($this->agent->is_referral())
-{
-    echo $this->agent->referrer();
-} - - -

$this->agent->agent_string()

-

Returns a string containing the full user agent string. Typically it will be something like this:

- -Mozilla/5.0 (Macintosh; U; Intel Mac OS X; en-US; rv:1.8.0.4) Gecko/20060613 Camino/1.0.2 - - -

$this->agent->accept_lang()

-

Lets you determine if the user agent accepts a particular language. Example:

- -if ($this->agent->accept_lang('en'))
-{
-    echo 'You accept English!';
-} - -

Note: This function is not typically very reliable -since some browsers do not provide language info, and even among those that do, it is not always accurate.

- - - -

$this->agent->accept_charset()

-

Lets you determine if the user agent accepts a particular language. Example:

- -if ($this->agent->accept_charset('utf-8'))
-{
-    echo 'You browser supports UTF-8!';
-} - -

Note: This function is not typically very reliable -since some browsers do not provide character-set info, and even among those that do, it is not always accurate.

- - - -
- - - - - - - \ No newline at end of file + CodeIgniter User Guide : User Agent Class

CodeIgniter User Guide Version 1.5.4

User Agent Class

The User Agent Class provides functions that help identify information about the browser, mobile device, or robot visiting your site. In addition you can get referrer information as well as language and supported character-set information.

Initializing the Class

Like most other classes in CodeIgniter, the User Agent class is initialized in your controller using the $this->load->library function:

$this->load->library('user_agent');

Once loaded, the object will be available using: $this->agent

User Agent Definitions

The user agent name definitions are located in a config file located at: application/config/user_agents.php. You may add items to the various user agent arrays if needed.

Example

When the User Agent class is initialized it will attempt to determine whether the user agent browsing your site is a web browser, a mobile device, or a robot. It will also gather the platform information if it is available.

$this->load->library('user_agent');

if ($this->agent->is_browser())
{
    $agent = $this->agent->browser().' '.$this->agent->version();
}
elseif ($this->agent->is_robot())
{
    $agent = $this->agent->robot();
}
elseif ($this->agent->is_mobile())
{
    $agent = $this->agent->mobile();
}
else
{
    $agent = 'Unidentified User Agent';
}

echo $agent;

echo $this->agent->platform(); // Platform info (Windows, Linux, Mac, etc.)

Function Reference

$this->agent->is_browser()

Returns TRUE/FALSE (boolean) if the user agent is a known web browser.

$this->agent->is_mobile()

Returns TRUE/FALSE (boolean) if the user agent is a known mobile device.

$this->agent->is_robot()

Returns TRUE/FALSE (boolean) if the user agent is a known robot.

Note:  The user agent library only contains the most common robot definitions. It is not a complete list of bots. There are hundreds of them so searching for each one would not be very efficient. If you find that some bots that commonly visit your site are missing from the list you can add them to your application/config/user_agents.php file.

$this->agent->is_referral()

Returns TRUE/FALSE (boolean) if the user agent was referred from another site.

$this->agent->browser()

Returns a string containing the name of the web browser viewing your site.

$this->agent->version()

Returns a string containing the version number of the web browser viewing your site.

$this->agent->mobile()

Returns a string containing the name of the mobile device viewing your site.

$this->agent->robot()

Returns a string containing the name of the robot viewing your site.

$this->agent->platform()

Returns a string containing the platform viewing your site (Linux, Windows, OS X, etc.).

$this->agent->referrer()

The referrer, if the user agent was referred from another site. Typically you'll test for this as follows:

if ($this->agent->is_referral())
{
    echo $this->agent->referrer();
}

$this->agent->agent_string()

Returns a string containing the full user agent string. Typically it will be something like this:

Mozilla/5.0 (Macintosh; U; Intel Mac OS X; en-US; rv:1.8.0.4) Gecko/20060613 Camino/1.0.2

$this->agent->accept_lang()

Lets you determine if the user agent accepts a particular language. Example:

if ($this->agent->accept_lang('en'))
{
    echo 'You accept English!';
}

Note: This function is not typically very reliable since some browsers do not provide language info, and even among those that do, it is not always accurate.

$this->agent->accept_charset()

Lets you determine if the user agent accepts a particular character set. Example:

if ($this->agent->accept_charset('utf-8'))
{
    echo 'You browser supports UTF-8!';
}

Note: This function is not typically very reliable since some browsers do not provide character-set info, and even among those that do, it is not always accurate.

\ No newline at end of file -- cgit v1.2.3-24-g4f1b