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/changelog.html | 2 +- user_guide/libraries/user_agent.html | 202 +---------------------------------- 2 files changed, 2 insertions(+), 202 deletions(-) diff --git a/user_guide/changelog.html b/user_guide/changelog.html index babb020c5..6d94d4ace 100644 --- a/user_guide/changelog.html +++ b/user_guide/changelog.html @@ -1 +1 @@ - CodeIgniter User Guide : Change Log

CodeIgniter User Guide Version 1.5.4

Change Log

Version 1.5.5

Release Date: -- still in development

Version 1.5.4

Release Date: July 12, 2007

Version 1.5.3

Release Date: April 15, 2007

Version 1.5.2

Release Date: February 13, 2007

Version 1.5.1

Release Date: November 23, 2006

Version 1.5.0.1

Release Date: October 31, 2006

Version 1.5.0

Release Date: October 30, 2006

Version 1.4.1

Release Date: September 21, 2006

Version 1.4.0

Release Date: September 17, 2006

Version 1.3.3

Release Date: June 1, 2006

Version 1.3.2

Release Date: April 17, 2006

Version 1.3.1

Release Date: April 11, 2006

Version 1.3

Release Date: April 3, 2006

Version 1.2

Release Date: March 21, 2006

Version Beta 1.1

Release Date: March 10, 2006

Version Beta 1.0

Release Date: February 28, 2006

First publicly released version.

\ No newline at end of file + CodeIgniter User Guide : Change Log

CodeIgniter User Guide Version 1.5.4

Change Log

Version 1.5.5

Release Date: -- still in development

Version 1.5.4

Release Date: July 12, 2007

Version 1.5.3

Release Date: April 15, 2007

Version 1.5.2

Release Date: February 13, 2007

Version 1.5.1

Release Date: November 23, 2006

Version 1.5.0.1

Release Date: October 31, 2006

Version 1.5.0

Release Date: October 30, 2006

Version 1.4.1

Release Date: September 21, 2006

Version 1.4.0

Release Date: September 17, 2006

Version 1.3.3

Release Date: June 1, 2006

Version 1.3.2

Release Date: April 17, 2006

Version 1.3.1

Release Date: April 11, 2006

Version 1.3

Release Date: April 3, 2006

Version 1.2

Release Date: March 21, 2006

Version Beta 1.1

Release Date: March 10, 2006

Version Beta 1.0

Release Date: February 28, 2006

First publicly released version.

\ No newline at end of file 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