blob: 51b120d96bbae087a3b8df0d89b4600b1a58426e (
plain)
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
|
Embed plugin
CONTENTS:
1. Overview
2. Adding a Tab
3. Populating a Select Tab
4. Populating an Upload Tab
5. Other WYSIWYG Editors and Embed
1. Overview
The Embed plugin is a simple way to allow users to link to or embed
their personal network content or third party resources in any text area.
The Embed plugin adds a menu item to the longtext menu. Clicking on this
link pops up a lightbox. The lightbox supports lists of content for insertion
and uploading new content.
2. Adding a Tab
The Embed plugin uses the menu system to manage its tabs. Use
elgg_register_menu_item() for the embed menu to add a new tab like this:
$item = ElggMenuItem::factory(array(
'name' => 'file',
'text' => elgg_echo('file'),
'priority' => 10,
'data' => array(
'options' => array(
'type' => 'object',
'subtype' => 'file',
),
),
));
elgg_register_menu_item('embed', $item);
Parameters:
name: The unique name of the tab.
text: The text shown on the tab
priority: Placement of the tab.
data: An array of parameters for creating the tab and its content.
When listing content using the embed list view, pass the options for the
elgg_list_entities() function as 'options'.
When using a custom view for listing content or for uploading new
content, pass the view name as 'view'.
See the file plugin for examples of registering both tab types.
3. Populating a Content Select Tab
Nothing should be required other than setting the options parameter array
when registering the tab. See the view embed/item to see how an entity is
rendered.
If creating a custom list, the <li> elements must have a class of .embed-item.
The HTML content that is inserted must use the class .embed-insert.
4. Populating an Upload Tab
The view that is registered must be defined. It must include a form for
uploading the content. The form must .elgg-form-embed. Somewhere in the view
must be a hidden input field with the name embed_hidden with its value be
the name of the tab to forward the user to when uploading is complete.
See the view embed/file_upload/content for an example
5. Other WYSIWYG Editors and Embed
Embed ships with support for the default input/longtext textarea.
Plugins replacing this view are expected to include JaVascript to
allow embed to work with the new editors.
To add custom JavaScript into the Embed plugin's elgg.embed.insert() function,
override the view embed/custom_insert_js. The textarea jQuery object is
available as the variable textArea and the content to be inserted is the
variable content. See the TinyMCE plugin for an example of this view.
|
