1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
#############
Smiley Helper
#############
The Smiley Helper file contains functions that let you manage smileys
(emoticons).
.. contents:: Page Contents
Loading this Helper
===================
This helper is loaded using the following code
::
$this->load->helper('smiley');
Overview
========
The Smiley helper has a renderer that takes plain text simileys, like
:-) and turns them into a image representation, like |smile!|
It also lets you display a set of smiley images that when clicked will
be inserted into a form field. For example, if you have a blog that
allows user commenting you can show the smileys next to the comment
form. Your users can click a desired smiley and with the help of some
JavaScript it will be placed into the form field.
Clickable Smileys Tutorial
==========================
Here is an example demonstrating how you might create a set of clickable
smileys next to a form field. This example requires that you first
download and install the smiley images, then create a controller and the
View as described.
.. important:: Before you begin, please `download the smiley images <http://codeigniter.com/download_files/smileys.zip>`_
and put them in a publicly accessible place on your server. This helper
also assumes you have the smiley replacement array located at
`application/config/smileys.php`
The Controller
--------------
In your `application/controllers/` folder, create a file called
smileys.php and place the code below in it.
.. important:: Change the URL in the `get_clickable_smileys()`
function below so that it points to your smiley folder.
You'll notice that in addition to the smiley helper we are using the :doc:`Table Class <../libraries/table>`.
::
<?php
class Smileys extends CI_Controller {
function index()
{
$this->load->helper('smiley');
$this->load->library('table');
$image_array = get_clickable_smileys('http://example.com/images/smileys/', 'comments');
$col_array = $this->table->make_columns($image_array, 8);
$data['smiley_table'] = $this->table->generate($col_array);
$this->load->view('smiley_view', $data);
}
}
In your `application/views/` folder, create a file called `smiley_view.php`
and place this code in it:
::
<html>
<head>
<title>Smileys</title>
<?php echo smiley_js(); ?>
</head>
<body>
<form name="blog">
<textarea name="comments" id="comments" cols="40" rows="4"></textarea>
</form>
<p>Click to insert a smiley!</p>
<?php echo $smiley_table; ?> </body> </html>
When you have created the above controller and view, load it by visiting http://www.example.com/index.php/smileys/
</body>
</html>
Field Aliases
-------------
When making changes to a view it can be inconvenient to have the field
id in the controller. To work around this, you can give your smiley
links a generic name that will be tied to a specific id in your view.
::
$image_array = get_smiley_links("http://example.com/images/smileys/", "comment_textarea_alias");
To map the alias to the field id, pass them both into the `smiley_js`
function
::
$image_array = smiley_js("comment_textarea_alias", "comments");
******************
Function Reference
******************
get_clickable_smileys()
=======================
Returns an array containing your smiley images wrapped in a clickable
link. You must supply the URL to your smiley folder and a field id or
field alias.
::
$image_array = get_smiley_links("http://example.com/images/smileys/", "comment");
Note: Usage of this function without the second parameter, in
combination with `js_insert_smiley` has been deprecated.
smiley_js()
===========
Generates the JavaScript that allows the images to be clicked and
inserted into a form field. If you supplied an alias instead of an id
when generating your smiley links, you need to pass the alias and
corresponding form id into the function. This function is designed to be
placed into the <head> area of your web page.
::
<?php echo smiley_js(); ?>
Note: This function replaces `js_insert_smiley`, which has been
deprecated.
parse_smileys()
===============
Takes a string of text as input and replaces any contained plain text
smileys into the image equivalent. The first parameter must contain your
string, the second must contain the URL to your smiley folder
::
$str = 'Here are some simileys: :-) ;-)';
$str = parse_smileys($str, "http://example.com/images/smileys/");
echo $str;
.. |smile!| image:: ../images/smile.gif
|
