forked from embedly/embedly_wordpress_plugin
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
347 lines (205 loc) · 7.81 KB
/
readme.txt
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
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
=== Embedly ===
Contributors: Embedly
Tags: embed, oembed, video, image, pdf, card
Requires at least: 3.8
Tested up to: 4.7
Stable tag: 4.7.10
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html
The Embedly Plugin extends Wordpress's auto-embed feature to give your blog more media types and style optons.
== Description ==
Enhance the default Wordpress embedding to get previews for any article,
including your own blog posts. You also get embeds for Gfycat, Twitch, Google
Maps, and Embedly’s growing list of [400+ supported
providers](http://embed.ly/providers).
You can customize the style of the embeds, to optimize for darker WP themes,
alignment, and width. In addition, social buttons can be added around the embeds
to make it easier to share content from your blog posts.
If you have an Embedly Cards account, you can link it to the plugin with your Embedly API key. Not only does this remove branding from the cards, it also gives you access to analytics and viewer behaviors for most popular music and video player embeds (YouTube, Vimeo, Instagram, SoundCloud). Find out how many people viewed your embeds for how long. To learn more about Embedly Cards please visit [our website](http://embed.ly/cards).
Using it is as simple as the default Wordpress embedding. Embed media by pasting its URL in a single line when writing a post
The plugin automatically displays an embed of the media in the Wordpress post
editor (for WP 4.0+).
Fair Warning: This plugin generates static HTML content for your posts. After you deactivate
the plugin, that HTML will still remain behind in all posts where the plugin was used to create
embeds.
== Installation ==
Using the Plugin Manager
1. Click Plugins in the Wordpress Dashboard sidebar.
1. Click Add New.
1. Search for Embedly.
1. Click Install
1. Click Install Now
1. Click Activate Plugin
1. Create a new post and paste a URL. It will automatically turn into an embed.
1. (optional) Save your Embedly API key to link your Embedly Cards account for analytics and unbranding
Manually
1. Upload `embedly` to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Go through the sign up flow as described above.
Multi-Site
1. Navigate to My Sites -> Network Admin
1. Follow Steps 1-5 in Using the Plugin Manager setup above, `Do not Network Activate`
1. Go to each site's dashboard and activate Embedly in Plugins section
1. Go through the sign up flow as described above.
== Frequently Asked Questions ==
=
Is this plugin for me?
=
Yes
=
Where do I get a key?
=
You can obtain a key when sign up for an Embedly account. You
can also get your key anytime by going to your [Embedly
account](http://app.embed.ly).
=
How do I embed "any" URL?
=
In the post editor, once the plugin is installed, paste in the URL you are
trying to embed.
=
What happens after I deactivate the plugin or delete my Embedly account?
=
Cards will remain active even if you delete the plugin and/or delete your Embedly account. This happens
because after we generate a card for your post, it is converted into static HTML. This HTML gets saved
to the post. Removing the plugin has no effect on posts that were created in the past.
=
I updated a setting for an embed but the embed didn't reflect the change?
=
Advanced Settings only affect newly generated cards. If you wish to change the appearance of a pre-existing
card, you will have to recreate the card in the post editor after making any settings changes.
=
Do I need a key?
=
No. An Embedly API key is optional. It's only required if you have an Embedly Cards account and you want to remove embedly branding or you want to view analytics about the content embedded on your posts.
=
What is your support email?
=
=
Do you support multi-site?
=
Yes, see steps above to install for multi-site.
Note: You will need to activate Embedly for each site.
=
Can the width and alignment be changed?
=
Yes! Both the width and alignment can be changed for embeds that use the plugin.
You can make these adjustments under Advanced Embed Settings in the Embedly
plugin settings in your Wordpress Dashboard.
=
Can I change the CSS of the embeds?
=
No, but you have a few options in styling under the Advanced Embed Settings section of
the Embedly plugin dashboard.
=
What options are there for styling the embeds?
=
You can change the width, alignment, and adjust the cards to work better for
darker themes.
=
How do I find more analytics?
=
You can view the full set of analytics on your embed by going to your account
dashboard.
=
How does this affect my SEO?
=
The embeds from the Embedly Wordpress plugin include title and description meta
information that can provide relevant information to search engines about the
embeds to boost SEO.
== Screenshots ==
1. Advanced Embed Settings
2. Writing a post and embedding.
3. Sample Post.
== Changelog ==
= 4.7.0 =
* Having an active app.embed.ly account is now optional to use the plugin! Users who want access to unbranded
card embeds and/or analytics can elect to input their Embedly API key in the plugin settings, but users who just want
to get started embedding no longer need to create an embedly account and activate the plugin.
= 4.0.9 =
* Improved plugin security.
= 4.0.6 =
* Embedly is not currently supporting historical analytics for embeds, but you can still see realtime views.
* Improves the implementation of javascript dependencies via the wp_enqueue_script api.
= 4.0 =
* Removed Embedly TinyMCE Button.
* Added Editor Preview URL functionality for all URLS (WP v4.0+)
* Redesigned Embedly Admin page
* All embeds will be generated as Embedly Cards
= 3.2 =
* Embedly TinyMCE dialog and dependencies managed server side.
* Refactor code to use class structure.
* Clean up deprecated SQL generation to make compliant with WP3.6 and above.
= 3.1.3 =
* Fix Add Post bug in IE.
= 3.1.2 =
* Enable Twitter WP OEmbed.
= 3.1 =
* Fixes issue with Embedly not loading on WP3.9.
* Load tiny_mce_popup_4_0.js when TinyMCE is v4.0.
= 3.0 =
* Upgrade Embedly TinyMce editor option to use Embedly Cards.
= 2.3.0 =
* Use TinyMCE provided by WP Core.
* Fixes issue with HTML editting and formatting.
= 2.2.2 =
* Change server side calls to HTTP to avoid issues.
* Disable rocketloader syntax.
= 2.2 =
* Update TinyMce Popup js to latest.
* Update to latest JQuery 1.10.2.
* Update Powered by link destination to code generator.
* Fix powered by logo for RSS generation.
* Add support for links to open in new window.
= 2.1.4 =
* Support for blogs using HTTPS.
* Steps for multi-site setup.
= 2.1.2 =
* Use wp-includes tiny_mce_popup.js
* Compatible with WP 3.5
= 2.1.1 =
* Providers save fix.
= 2.1 =
* Admin Redesign.
* embedly_settngs option for wp_options table.
* SQL optimizations.
= 2.0.9 =
* Fix for feature status check.
= 2.0.8 =
* Allow script tag embeds.
= 2.0.6 =
* Add Embedly providers on 'plugins_loaded' instead of 'init' and other tweaks
= 2.0.5 =
* Fixing the path to TinyMCE plugin.
= 2.0.4 =
* Updated flow for previewing and updating embeds.
* Improved previews for preview endpoint.
* Better error handling for loading plugin in Post Editor.
= 2.0.3 =
* Resolve issue with tag attributes getting stripped
* Resolve quirks with height getting set incorrectly
= 2.0.2 =
* Resolve conflict with WordPress image editing
= 2.0.1 =
* Resolves Rich Editor not showing up.
= 2.0 =
* Adds Embedly TinyMCE plugin to Rich Editor.
* Support for Embedly Key to Embed "any" URL.
= 1.0 =
A few fixes.
= 0.9 =
Initial Version
== Upgrade Notice ==
= 2.0 =
Embed "any" URL.
= 2.1 =
Admin Redesign.
= 2.2 =
Update tinymce and jquery libs.
= 3.0 =
Embedly rich post editor option now uses Embedly Cards layout.
= 3.1 =
Dynamically loading Embedly popup based on TinyMCE Version.
= 3.2 =
Refactor Embedly TinyMCE Dialog to generate via iframe request.