-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
421 lines (302 loc) · 16.3 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
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
=== Plugin Name ===
Contributors: MrMaz
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=8591311
Tags: buddypress, social, networking, links, rich media, embed, youtube, flickr
Requires at least: 4.0
Tested up to: 4.3.1
Stable tag: 0.9.4.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
BuddyPress Links is a drop-in link, image, video and other rich media sharing component for BuddyPress 2.0 and higher
== Description ==
#### Overview
If you're running a BuddyPress community, and would like to give your members the ability to
easily share content from across the web, this is your solution! BuddyPress Links allows your
members to quickly and easily share links, images, videos, and other rich content.
All links that are shared by your community (with privacy mode set to public) are displayed
in a central directory where your members can filter, vote, and comment on them.
**Our demo is back online since July 24, 2015!**
If you are anxious to try it out, go to the fully functional demo: http://demo.presscrew.com/
#### Deep Integration
Links is fully integrated with these BuddyPress core components:
> *Profiles, Activity Stream, Widgets, Notifications, Admin Bar, Admin Dashboard*
This deep integration adds a powerful new social tool through which your members can interact:
* Your members can see the links they've submitted on their own profile, as well as other's.
* Privacy settings allow your members to have total control over who sees which links.
* A new activity stream tab is added so your members can quickly see new links which have been added by friends or by other members from across the site.
* Your members can comment and vote on each other's links.
* A powerful ranking algorithm turns your links directory into a social book-marking destination.
We've seen some amazing examples of BuddyPress Links in action. Use it to create a directory of images or videos (with built-in lightbox support) for your members to vote upon. Or use it to build a tutorial section of your community with links pointing to articles or rich media from across the web. BuddyPress Links is flexible enough to handle it all.
#### Feature List
Members can:
* Create and manage links from their profile
* Assign links to a category
* Control the visibility of their links (public, friends only, and hidden)
* Upload an image "avatar" to show with a link
* Auto embed rich media from URLs (YouTube, Flickr, etc...)
* Automatic thumbnail picker
* Vote on other member's links
* Comment on other member's links
* @mentions support
Administrators can:
* Manage all links (modify, delete)
* Manage link categories (create, modify, delete)
* Enable and customize widgets
Other features include:
* "Digg style" popularity algorithm
* Rich profile and directory sorting and filtering
* Most recent links news feed
* Hundreds of action and filter hooks
* Full i18n support (need translators!)
== Screenshots ==
1. Links behaves just like a root component, complete with its own directory for links which have their privacy set to public.
2. Links for embedded videos and images play in a modal window at their original size.
3. Links is fully integrated into the activity stream, including several powerful filters for limiting results.
4. When creating a link, rich media and thumbnails are auto-detected. Quickly select a thumbnail to display for the link.
5. Edit fetched link content to clean up title and description, or to completely customize the content to your liking.
6. You can choose to use the fetched thumbnail, or to upload a custom image from your computer.
7. Each link has its own privacy setting for full control over who sees your links.
8. Uploading a custom link image (avatar) is identical to other root components.
9. Links is fully integrated into member profiles. View link related activity for yourself or another member. Conveniently create a new link directly from your profile.
10. Links activity is integrated into the profile, just like the core components.
11. A BuddyPress compatible link list widget is available to add to any sidebar. Advanced filtering and sorting is possible directly in the widget.
12. Links completely integrates with the groups component (pro version only). Group members can add links to the group. All group link activity is visible from the group’s activity page. Group administrators have full control over which links are allowed.
13. Easily share an existing link with your profile or any group you are a member of (pro version only). Use this powerful feature to track external resources for yourself, or inside of a group.
14. Links has a complete set of administration tools available in the WordPress dashboard.
15. Manage all links from a central location.
16. Manage available link categories.
== Installation ==
* BuddyPress Links 0.9.4 requires WordPress 4.0 or higher with BuddyPress 2.0 or higher installed.
* BuddyPress Links 0.9.x requires WordPress 3.6 or higher with BuddyPress 1.8 or higher installed.
* BuddyPress Links 0.8.x requires WordPress 3.5 or higher with BuddyPress 1.6 or higher installed.
* BuddyPress Links 0.7.x requires WordPress 3.4 or higher with BuddyPress 1.6 or higher installed.
* BuddyPress Links 0.6.x requires WordPress 3.3 or higher with BuddyPress 1.5 or higher installed.
* BuddyPress Links 0.5.x requires WordPress 3.0 or higher with BuddyPress 1.2.6 or higher installed.
* BuddyPress Links 0.4.x requires WordPress 2.9.2 or higher with BuddyPress 1.2.x installed.
* BuddyPress Links 0.3.x requires WordPress 2.9.1 or higher with BuddyPress 1.2.x installed.
* BuddyPress Links 0.2.x requires WordPress 2.8.4 or higher with BuddyPress 1.1.x installed.
#### Plugin:
1. Upload everything into the "/wp-content/plugins" directory of your installation.
1. Activate BuddyPress Links in the "Plugins" admin panel using the "Activate" link.
1. Go to Dashboard > BuddyPress Links > Support for remaining setup steps.
#### Upgrading from an earlier version:
1. BACK UP ALL OF YOUR DATA.
1. The wire has been deprecated as of 0.3. ALL LINKS WIRE POSTS WILL BE LOST!
1. This version can use data created by previous versions, assuming you are porting your site to the new BP 1.2 default theme!
#### Warning!
The 0.3.x and higher branches are not backwards compatible with the BuddyPress 1.1.x branch, or compatible with the 1.2.x classic theme.
The links data from the 0.2.x branch is compatible with 0.3.x and higher, except that all links wire posts will be lost.
== Upgrade Notice ==
= 0.9.4 =
The MetaCafe API is completely defunct. No new attempts to fetch data will be made, although existing links
should still display fine. New links to MetaCafe will fall back to page fetching.
= 0.9 =
Several templates were modified.
= 0.8.2 =
On activation, all URL hashes will be regenerated to fix database values which were being inserted incorrectly.
= 0.8 =
No changes that affect data were made, however it is always a good idea to back up your data just in case!
= 0.7 =
No changes that affect data were made, however it is always a good idea to back up your data just in case!
== Changelog ==
= 0.9.4.2 =
* Bug
* [BPL-30] - Single link comments are broken
= 0.9.4.1 =
* Bug
* [BPL-29] - Settings tabs are not working as separate pages.
= 0.9.4 =
* Story
* [BPL-10] - Improve admin interfaces
* Task
* [BPL-26] - MetaCafe API is no longer reliable, fall back to page fetching
* [BPL-27] - Update Flickr API URL and embed code to latest
* [BPL-28] - Remove PicApp and Fotoglif fetching, both sites are defunct
* Bug
* [BPL-24] - Database tables not being created on activation
* [BPL-25] - YouTube videos not being fetched properly
= 0.9.3 =
* Bug
* [BPL-21] - Navigation issues related to bp-legacy templates
* [BPL-22] - Form templates are sometimes being included twice
* [BPL-23] - Improve CSS compat with bp-legacy templates
= 0.9.2 =
* Bug
* [BPL-2] - Broken sidebar
* [BPL-3] - Issue with multi-network installation tables
* [BPL-4] - Pro settings are frozen with BP 2.2
= 0.9.1 =
* Compatibility hot fix for BuddyPress 2.2.
= 0.9 =
* Compatibility testing up to BuddyPress 1.9.1
* Added BuddyPress "legacy" theme support (1.8 and higher)
* Compatibility testing with the Twenty Thirteen and Twenty Fourteen themes
* Added new setting to allow disabling of the my links tab on the main directory navigation
* Added new setting for customizing order by items, their wording, and order
* Added new setting for customizing the default order by selection
* Added new setting for max tabs to show in directory navigation
* Fixed non-logged in user trying to vote error message
* Additional minor bug fixes
= 0.8.2 =
* Compatibility testing up to BuddyPress 1.7.3
* Added new setting to disable page fetching
* Added new setting to use numeric ids in permalinks instead of slugs
* Added new setting to prevent duplicate URLs from being submitted to directory
* Link Manager (dashboard) now shows newest links first
* Several minor bug fixes
= 0.8.1 =
* Fixed broken page details fetching
= 0.8 =
* Compatibility testing and tweaks to fully support BuddyPress 1.7
* Added setting to completely disable voting
* Added setting to disable down votes (only up vote clicker shows)
* Added setting to hide avatar options box on create/edit link form
* Added setting to hide advanced settings box on create/edit link form
* Fixed broken custom avatar uploading that affected some BuddyPress 1.7 installs
* Fixed missing links directory page title
* Fixed broken comments issue
* Misc performance tweaks
= 0.7.2 =
* Updated URL patterns to support secure links (https)
* Changed default management capability and make it an overridable constant
= 0.7.1 =
* Removed custom cron scheduling due to plugin conflicts
* Fixed pagination of links manager admin screen
* Killed colorbox dynamic image window sizing in favor of fixed size
* Minor fixes to resolve issues related to WordPress 3.5
= 0.7 =
* Added new settings screen, sweet!
* Added activity nav item position setting
* Vote panel template tags now print unescaped html instead of passing to sprintf()
* Cleaned up admin screen html, added sidebar with upgrade links and other info
= 0.6.6 =
* Fixed friends only privacy setting was displayed even when friends component disabled
* Fixed admin bar items showing up when user not logged in
* Fixed issue with slugs containing extended characters
* Fixed dashboard styles that were in conflict with other plugins
= 0.6.5 =
* Fixed embedded video issues caused by responsive themes
* Upgraded to Colorbox 1.3.2
* Fixing missing sidebar on create link page
* Additional BuddyPress 1.6.x fixes
= 0.6.4 =
* Removed group integration
* Removed profile sharing
= 0.6.3 =
* PHP 5.4.x compatibility fixes
* BuddyPress 1.6.x compatibility fixes
= 0.6.2 =
* Wrap link loop item category with span
* Clean up style enqueueing
* Added constant to force external link from directory listing
= 0.6.1 =
* Sidebar widget works again
* Automatically fix URLs which are entered without http://
* Fixed link list pagination issues
* Fixed possible link list filtering issues
* Fixed AJAX spinner when fetching details
= 0.6 =
* Upgraded to latest version of colorbox
* Moved dashboard menu to its own top level spot
* Fixed navigation menu formatting
* Fixed create/edit form errors not displaying
* Fixed issue with videos not playing
* Fixed double link in global navigation
* Fixed link home sub-navigation not displaying
* Fixed avatars not displaying properly
* Fixed broken custom avatar uploading
* Many additional minor BuddyPress 1.5 compatibility fixes
= 0.5 =
* Tested with WordPress 3.x and BuddyPress 1.2.6
* Improved compatibility when groups component is disabled
* Improved compatibility when activity component is disabled
* Added configuration constant for disabling groups integration
* Added configuration constant for using select box for categories on create form
* Added filter to bp_links_is_url_valid() to allow extended validation
* Fixed pubdate bug in feed generator
* Fixed linkmeta bug where empty values where being passed to array_map()
* Updated RU translation, props SlaFFik
= 0.4.1 =
* Fixed comment count bug
* Fixed nasty bug that caused filtering not to work for specific translations
* Fixed some translatable string issues, props SlaFFik
* Updated RU translation, props SlaFFik
= 0.4 =
* Initial group integration support added
* Added profile and group sharing features
* Create link directly from user profile and group pages
* Moved link list update/error messages to inside the current link's li block
* Added external link icon next to main link URL on the link list
* All link list targets and rels are no longer set by default and must be explicitly set with a filter
* All link list content is now separately filterable for finer control over URLs and content
* Load members profile links using plugins template instead of members home action
* Link description can be configured as optional with a constant
* Usability fixes to the link create/admin form (props Mike Pratt)
* Changing the component slug is now officially supported
* Heavy duty javascript refactoring
= 0.3.2 =
* Fixed broken paging
* Fixed bug with status check in some queries
* My Links now correctly only shows the displayed user's links
* My Links activity now correctly only shows the displayed user's links activity
= 0.3.1 =
* Fixed nasty SQL query bug, big props to windhamdavid
* Fixed broken category filtering that affected recently active links for single user
* Updated French translations, props Chouf1
* Added German translation, props Michael Berra
* Added Swedish translation, props Ezbizniz
= 0.3 =
* Baseline BuddyPress 1.2 support, REQUIRES BP 1.2 or higher
* Removed classic theme support (may re-support in the future if there is a huge demand)
* Wire support has been dropped and replaced with the activity stream
* Deep and seamless activity stream integration, complete with RSS feeds
* @mentions support, complete with e-mail notifications
* Lightbox for viewing photos and videos without leaving the site
* Moved template files to plugin dir to ease future upgrading
* Added support for template overriding from child theme
* Moved link loop item HTML from hard coded PHP to a template (links-loop-item.php)
* Added the much requested filters for link REL and TARGET
* Completely hooked into default theme AJAX (no duplicate functionality)
* Removed redundant "Home" link from link list
* Major overhaul of how we hook into the dashboard
* Replaced full blown widget with a basic widget based on groups
* Replaced custom elapsed time function with bp_core_time_since for continuity
* Added filters for changing navigation tab names.
* Fixed many old bugs
= 0.2.1 =
* Added support for auto embedding standard web pages
* Added automatic thumb picker for rich web pages
* Fixed layout bug that was affecting all webkit browsers
* Some other minor bug fixes
= 0.2 =
* Added support for auto-embedding of rich media (API documentation coming soon!)
* Reduced create/admin form to one page
* Wider selection of thumb sizes for the links widget
* Many CSS improvements and fixes
* Lots of general refactoring
* Some minor bug fixes
= 0.1 =
* First beta versions
* Many, many i18n fixes
* A few bug fixes
== Frequently Asked Questions ==
= What is the license? =
Released under the GNU GENERAL PUBLIC LICENSE 2.0 or later (http://www.gnu.org/licenses/gpl-2.0.html)
All original code is Copyright (c) 2009-2015 Marshall Sorenson. All rights reserved.
= How do I customize the default templates? =
To override only certain templates from the bp-links-default theme directory,
create a directory named "bp-links-default" in your child theme,
and replace the template using the EXACT same path AND filename.
To create a totally custom theme in order to completely bypass any core links
themes you will need to define a custom theme name.
For example, if your active WordPress theme is 'bluesky', and you wanted
to define your links theme as 'links-custom', you would put your files in:
/path/to/wp-content/themes/bluesky/links-custom
And in wp-config.php you would place this define statement:
define( 'BP_LINKS_CUSTOM_THEME', 'links-custom' )
To find out which template files are required to exist, do a recursive search for 'bp_links_load_template'
= Where can I get support? =
WordPress.org https://wordpress.org/support/plugin/buddypress-links/
Please search the forums first!!!
= Where can I report a bug? =
GitHub.com https://github.com/PressCrew/buddypress-links/issues