rtMedia for WordPress, BuddyPress and bbPress vs Photogallery

rtMedia is the only complete media solution for WordPress, BuddyPress and bbPress, and is WordPress.com VIP compatible. Built with a mobile-first approach, it works on mobile/tablet devices (like iPhone/iPad, Android). Live Demos If you’re in a hurry, you can skip the long list of features in subsequent sections and just explore live demos! rtMedia Demo Video Tour Since rtMedia has many features video doesn’t include all features: rtMedia Features WordPress Integration – Display media on WordPress author pages ( eg: http://demo.rtmedia.io/author/admin/media/ ) BuddyPress Integration – Find a new media tab under BuddyPress Profiles & Groups. BuddyPress Activity Stream – Attach media to activity status updates just like Facebook. Albums – Organise media into manageable collections. BuddyPress Group albums support collaboration. Responsive – Album Slideshow (Lightbox), video player, uploads work on mobiles & tablets. Support for swipe gestures. Privacy – Control who can see media files, albums and BuddyPress activities. Templating system – Completely customise rtMedia by modifying the template files. Just copy over the template folder to your theme. Featured Media – This can be used for facebook-style cover photo on profiles. rtMedia Uploader – Use [rtmedia_uploader] shortcode or template tag, to show drag-n-drop uploader in any WordPress area (post, page, custom-post, etc). rtMedia Gallery – Display media gallery anywhere on your site using [rtmedia_gallery] shortcode or template tag. Upload-Terms – This feature is useful to set terms of services page on website during user upload media on website. Audio/Video Conversion You can use the GoDAM Plugin for Audio/Video transcoding. rtMedia Premium Features Instagram-Effects – Users can apply Instagram like filters to photos. Photo-Tagging – Users can tag their friends/other users in photos. Photo-Watermark – rtMedia Photo Watermark feature let you watermarked or copyright your uploaded photos.) Membership – It provides membership functionality in your site. Social-Sync – It allows you to import media from your Facebook account. myCRED-Points – It allows you to integrate rtMedia with myCRED and award virtual points for various rtMedia activities, like media upload, likes, deleted, albums creation, playlist, etc. Playlists – This feature is used to create a playlist for uploaded music file with rtMedia. Favorites – This feature allows users to create their own list of favorite media. Moderation – This feature is for reporting media if user find offensive. Custom-Attributes – This feature is for categorizing media using attributes defined by site owner when uploading. Docs-and-Other-files – This feature allows uploading for doc, pdf and other file types such as zip, tar, etc. Default-Albums – This feature allows the creation of multiple default albums for rtMedia uploads. Podcast-Feed – Read rtMedia uploads from iTunes as well as any RSS feed-reader/podcasting software. Restrictions – Site admin can set limits in terms of total size & file count. bbPress-Attachments – Attach media files to bbPress forum topics and replies. WordPress-Sitewide-Gallery – Site admin can create and upload media into WordPress album. WordPress-Comment-Attachments – Allow users to upload a media file in WordPress comment attachment box. Social-Sharing – Share uploaded media on social network sites like Facebook, twitter, linkedin, Google+. This addon integrate with rtSocial plugin. Sidebar-Widgets – This feature provide widgets to upload media and display gallery for rtMedia plugin. 5-Star-Ratings – User can rate the media files from 1 to 5 star. Edit-Mp3-Info-(ID3 Tags) – Allow user to edit MP3 FIle Audio tags (ID 3 tags). Sorting – Sort uploaded media based on file size, ascending/descending title, upload date of media. Bulk-Edit – Allow users to move files from one album to another, change attributes, change privacy, delete files in bulk. BuddyPress-Profile-Picture – Allow users to set their profile picture from existing uploaded media file. Album-Cover-Art – Allow users to set album cover from uploaded image. Direct-Download-Link – This feature provide a download button for all the uploaded media. Upload-by-URL – Allow users to upload media using absolute URL. Likes – This feature let you know who liked media. User can also see which media file he/she liked under user profile. Activity-URL-Preview – This feature provides a preview of the URL that is shared and shows up on BuddyPress activity. View-Counter – Enable view count for all the uploaded media. Shortcode-Generator – The shortcode generator button added in WordPress post and page editor for all the rtMedia shortcodes. Album-Privacy – Set album privacy when user create new albums or edit album. BuddyPress-Group-Media-Control – Allow group owner to provide media upload feature for their group. Set-Custom-Thumbnail-for-Audio/Video – Allow media owner to change the thumbnail of uploaded audio/video files. rtMedia-SEO – Generate XML sitemap of all the public media files uploaded via rtMedia plugin, also compatible with Yoast-SEO plugin if you are already using on your site. Important Links Project Homepage Documentation FAQ Support GitHub – Please mention your wordpress.org username when sending pull requests. Sponsors Henry Wright has kindly sponsored the Featured Media feature. 优素映像 (Yousu Image) has sponsored the latest Like feature which doesn’t depend on BuddyPress, any more. Richard Ellis has sponsored the profile picture along with the link back to the profile in the media pop ups. Translation rtMedia includes full translation support. Head over to the translation project to contribute your translations. If you don’t see the language of your choice, let us know in the support forum, we’ll add it. Dutch translation by [carry2web] (https://profiles.wordpress.org/carry2web) Italian translation by [Paolo] Dutch translation by rjpj Polish translation by Polski_Ziom Spanish translation by Andrés Felipe and [d3ne] Solvak translation by igid26 Italian translation by [Yukiko.Kawa] Persian translation by mahdiar German translation by [hannes.muc] (Note: Credits are given for translations that are at least 50% complete.) Credits rtMedia uses the following projects/sources for some functionality MediaElement.js for html5 audio/video player Magnific Popup for responsive lightbox getID3 gets us some ID tags for the media Foundation for the media grid and layout Backbone.js for an MVC architecture for the frontend

This plugin is meant primarily for theme developers. This plugin allows to collect photos from the the Media Manager and arrange them into albums. These albums can be combined into galleries. Both albums and galleries can be added to a theme’s navigation menu. Note that this plugin does not provide any CSS formatting and JavaScript for frontend presentation of galleries and albums. You have to format them yourself and integrate necessary JavaScript libraries, e.g Lightbox, yourself. This plugin merely gives a framework for gallery and album creation via custom post types and registration of designs for a frontend presentation. If you found a bug or have any questions, complains or suggestions please feel free to contact me. Theme Integration You have to write post type template files for your theme in order for an album or gallery to work. This gives Theme developers the most control over a frontend presentation and users a convenient way to create galleries through the WordPress dashboard. If you install this plugin, create albums and galleries and include them into your theme’s menu, you will be disappointed, since nothing will happen. Create two php files inside your theme’s directory: single-photogallery.php and single-photoalbum.php. single-photogallery.php gets called everytime a gallery is about to be viewed single-photoalbum.php gets called everytime a album is about to be viewed Now you have two options. You can register a custom design inside your theme’s function.php via e.g $kt_Photogallery->register_gallery_design() and call $kt_Photogallery->render() at an appropriated place inside your single-photogallery.php to render it depending on the user’s choice. You fetch albums, images and thumbnail details, and render consistent HTML for all albums and galleries. Refere to the PHP API section for further details on how to retrieve album IDs, image IDs and thumbnail details. Example A basic example for a custom gallery design # functions.php $kt_Photogallery->register_gallery_design ('my_gallery_design', array( 'label' => __('My Gallery Design', 'my-textdomain'), 'icon' => 'dashicons-format-gallery', 'title' => __('This is my custom gallery design', 'my-textdomain'), 'render' => 'render_my_gallery_design' )); $kt_Photogallery->register_album_design ('my_album_design', array( 'label' => __('My Album Design', 'my-textdomain'), 'icon' => 'dashicons-format-image', 'title' => __('This is my custom album design', 'my-textdomain'), 'render' => 'render_my_album_design' )); function render_my_gallery_design ($post) { global $kt_Photogallery; $album_IDs = $kt_Photogallery->get_albums($post); if ($album_IDs) { foreach ($album_IDs as $album_ID) { $album_thumbnail = $kt_Photogallery->get_thumbnail_src($album_ID); echo ' '; if ($album_thumbnail) { echo ' '; } echo ' '; } } else { printf(__('The gallery %s does not contain any albums', 'my-textdomain'), esc_html($post->post_title)); } } function render_my_album_design ($post) { global $kt_Photogallery; $image_IDs = $kt_Photogallery->get_images($post); if ($image_IDs) { foreach ($image_IDs as $image_ID) { $image = get_post($image_ID); if ($image) { $image_src = wp_get_attachment_image_src($image_ID, 'medium'); if (!$image_src) { $image_src = wp_get_attachment_image_src($image_ID, 'full'); } echo ' '; } } } else { printf(__('The album %s does not contain any images', 'my-textdomain'), esc_html($post->post_title)); } } Basic integration into Twenty Fifteen: # single-photogallery.php or single-photoalbum.php get_header(); ?> ', ' '); ?> render(); ?> get_album_count ( [$gallery_ID] ) Returns the number of albums associated with a gallery Argument int|null $gallery_ID Optional – ID of a gallery. Defaults to the current ID if used inside the Loop Returns integer|boolean – Returns an integer on success, or false if $gallery_ID yields no gallery $kt_Photogallery->get_albums ( [$gallery_ID] ) Returns an array of album IDs associated with a gallery. Argument int|null $gallery_ID Optional – ID of a gallery. Defaults to the current ID if used inside the Loop Returns array|boolean – Returns an array of IDs on success, false if $gallery_ID yields no gallery $kt_Photogallery->get_image_count ( [$album_ID] ) Returns the number of images associated with an album Argument int|null $album_ID Optional – ID of an album. Defaults to the current ID if used inside the Loop Returns integer|boolean – Returns an integer on success, or false if $album_ID yields no album $kt_Photogallery->get_images ( [$album_ID] ) Returns an array of image IDs associated with an album. Argument int|null $album_ID Optional – ID of an album. Defaults to the current ID if used inside the Loop Returns array|boolean – Returns an array of IDs on success, false if $album_ID yields no album $kt_Photogallery->get_thumbnail ( [$album_ID, [$fallback] ] ) Returns the ID of the image (attachment) used as thumbnail for an album Argument int|null $album_ID Optional – ID of an album. Defaults to the current ID if used inside the Loop Argument boolean $fallback Optional – if true and $album_ID yields no album the method returns the ID of the first image associated with the album. Default is true Returns integer|false – Returns an integer on success, false if $album_ID yields no album, no thumbnail is set or a fallback could not been resolved $kt_Photogallery->get_thumbnail_src ( [$album_ID, [$fallback] ] ) Returns an ordered array with values corresponding to the (0) url, (1) width, (2) height and (3) scale of the thumbnail associated with an album. Argument int|null $album_ID Optional – ID of an album. Defaults to the current ID if used inside the Loop Argument boolean $fallback Optional – if true and $album_ID yields no album the method returns the ID of the first image associated with the album. Default is true Returns array|false – Returns an array on success, false if $album_ID yields no album, no thumbnail is set or a fallback could not been resolved $kt_Photogallery->register_album_design ( $key, $options ) $kt_Photogallery->register_gallery_design ( $key, $options ) Registers a custom design for albums and galleries respectively. The design will be available in the Design metabox during editing Returns boolean – returns true if the design was registered successfully, false on failure. Argument string $key Required – A key used as id inside HTML/CSS and for general identification Argument callable|array $options Required – A callback rendering the design on the frontend or an associative array: string label – The text for the label string icon – The image shown next to the label. Can be dashicons-*, an URL to an image or a base 64 encoded image string title – Text used inside the HTML title attribute, usually containing a description callback render ($post, $options) – Callback rendering the design on the frontend. The arguments passed are the current post as a WP_Post instance and an associative array of the options straight from the database callback options ($current_options, $defaults, $post) – Callback for additional form fields, should echo HTML. The arguments passed are an associative array of the options straight from the database, the default options as second argument and the current post as a WP_Post instance as third. array defaults – Associative array containing default values for options. Its keys are used during saving so you should generate HTML form fields using its keys and provide a callback for filtering. callback filter ($current_options, $defaults, $post) – Callback for filtering the options before they are saved. This callback is called every time a post is saved. The arguments passed are the default options merged with the values from the current request, the default options as second argument and the current post as a WP_Post instance as third. The callback must return an associative array otherwise no options are stored. $kt_Photogallery->render( [$auto_design] ) Main output method. Depending on the current post type the method prints out a design for a gallery or an album. Argument boolean auto_design optional – If set true and no design is found, take the first registered one and proceed. Default is true Returns boolean – Returns true on success, false otherwise