Title: BlueFeed
Author: Alex Hedström
Published: <strong>30 de marzo de 2026</strong>
Last modified: 31 de marzo de 2026

---

Buscar plugins

![](https://ps.w.org/bluefeed/assets/banner-772x250.png?rev=3494896)

![](https://ps.w.org/bluefeed/assets/icon-256x256.png?rev=3494896)

# BlueFeed

 Por [Alex Hedström](https://profiles.wordpress.org/alexhedstrom/)

[Descargar](https://downloads.wordpress.org/plugin/bluefeed.1.0.5.zip)

 * [Detalles](https://es.wordpress.org/plugins/bluefeed/#description)
 * [Valoraciones](https://es.wordpress.org/plugins/bluefeed/#reviews)
 *  [Instalación](https://es.wordpress.org/plugins/bluefeed/#installation)
 * [Desarrollo](https://es.wordpress.org/plugins/bluefeed/#developers)

 [Soporte](https://wordpress.org/support/plugin/bluefeed/)

## Descripción

**BlueFeed** lets you embed your Bluesky (AT Protocol) feed anywhere on your WordPress
site using the `[bluefeed]` shortcode. Choose from four beautiful layouts:

 * **Classic** – A familiar social-media timeline look
 * **Cards** – A responsive card grid, great for visual content
 * **Compact** – A minimal, space-efficient list view
 * **Images** – An Instagram-style square image grid showing only posts with images,
   with hover overlays for likes and comments

#### Features

 * 4 layout styles (classic, cards, compact, images)
 * Configurable column count for grid layouts
 * Profile header with avatar, banner, bio, and stats
 * Follow button linking to the Bluesky profile
 * Automatic caching with configurable duration for fast page loads
 * Stale-cache fallback — serves cached content if the API is temporarily unreachable
 * Clickable links and @mentions auto-linked
 * Repost indicators on classic layout
 * Color customization via admin settings or per-shortcode attributes
 * Test Connection button in admin to diagnose API connectivity
 * Compatible with page builders (Breakdance, Elementor, Beaver Builder, etc.)
 * Responsive design for all screen sizes
 * Works with the public Bluesky API — no authentication required

#### Shortcode Examples

    ```
    [bluefeed]
    [bluefeed layout="images" columns="4" count="12"]
    [bluefeed layout="compact" count="5" show_header="false"]
    [bluefeed handle="other.bsky.social" layout="classic"]
    ```

#### Shortcode Parameters

**Layout & Display:**

 * `layout` – classic, cards, compact, or images (default: classic)
 * `count` – Number of posts (default: 9, max 100)
 * `handle` – Override the Bluesky handle from settings
 * `columns` – Grid columns for images/cards (default: 3)
 * `gap` – Space between posts/cards in pixels (default: auto per layout)
 * `border_radius` – Corner rounding in pixels (default: 12, use 0 for square)
 * `border_width` – Border thickness in pixels (default: 1, images layout defaults
   to 0)
 * `show_header` – Show profile header: true/false (default: true)
 * `show_replies` – Include replies in the feed: true/false (default: false)
 * `show_images` – Show images in classic/cards layouts: true/false (default: false)
 * `show_follow` – Show follow button: true/false (default: true)
 * `show_caption` – Show post caption on hover in images layout: true/false (default:
   false)

**Color Overrides (hex values, e.g. #ffffff):**

 * `card_bg`, `placeholder_bg`, `post_text`, `meta_text`, `card_border`
 * `link_color`, `link_hover`, `row_hover_bg`, `header_name`
 * `follow_text`, `follow_bg`, `follow_border`, `follow_hover_text`, `follow_hover_bg`

### External services

This plugin connects to the **Bluesky public API** to retrieve and display Bluesky
social media content on your WordPress site. It is required for all plugin functionality—
without it, no feed or profile data can be displayed.

#### What data is sent and when

 * **Profile requests** – When a page containing the `[bluefeed]` shortcode is loaded,
   the plugin sends the configured Bluesky handle to the endpoint `https://public.
   api.bsky.app/xrpc/app.bsky.actor.getProfile` to retrieve the user’s profile information(
   display name, avatar, banner, bio, and follower/following/post counts).
 * **Feed requests** – On the same page load, the plugin sends the Bluesky handle
   along with display parameters (post count, filter type) to the endpoint `https://
   public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed` to retrieve the user’s 
   posts.

No visitor personal data, cookies, or tracking information is sent to the API. Responses
are cached locally on your server (default 15 minutes, configurable) to reduce the
number of external requests.

#### Service provider

This service is provided by **Bluesky PBC** ([bsky.app](https://bsky.app)).

 * [Terms of Service](https://bsky.social/about/support/tos)
 * [Privacy Policy](https://bsky.social/about/support/privacy-policy)

## Instalación

 1. Upload the `bluefeed` folder to `/wp-content/plugins/`
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Go to **Settings  BlueFeed** and enter your Bluesky handle
 4. Add the `[bluefeed]` shortcode to any page or post

## FAQ

### Do I need a Bluesky account?

You need a Bluesky handle to display a feed. The plugin uses the public API to fetch
posts — no App Password or authentication is required.

### Can I show multiple feeds on one page?

Yes! Use the `handle` parameter to show different accounts:

    ```
    [bluefeed handle="user1.bsky.social"]
    [bluefeed handle="user2.bsky.social"]
    ```

### How does the Images layout work?

The Images layout automatically filters to only show posts that contain images, 
displaying them in an Instagram-style square grid. When visitors hover over an image,
they see the reply, repost, and like counts.

### Can I customize the colors?

Yes. You can set global default colors in **Settings  BlueFeed  Color Customization**,
or override colors per-shortcode using color attributes like `card_bg="#1a1a2e"`.

### The feed shows a connection error. What should I do?

Go to **Settings  BlueFeed** and click **Test Connection**. This will tell you whether
your server can reach the Bluesky API. If it times out, your hosting provider may
be blocking outbound HTTPS requests — contact them to whitelist `public.api.bsky.
app`.

### How does caching work?

Feed data is cached for 15 minutes by default (configurable in settings). If the
API is temporarily unreachable, the plugin serves the last cached data instead of
showing an error.

## Reseñas

No hay valoraciones para este plugin.

## Colaboradores y desarrolladores

«BlueFeed» es un software de código abierto. Las siguientes personas han colaborado
con este plugin.

Colaboradores

 *   [ Alex Hedström ](https://profiles.wordpress.org/alexhedstrom/)

[Traduce «BlueFeed» a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/bluefeed)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/bluefeed/) , echa 
un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/bluefeed/) o suscríbete
al [registro de desarrollo](https://plugins.trac.wordpress.org/log/bluefeed/) por
[RSS](https://plugins.trac.wordpress.org/log/bluefeed/?limit=100&mode=stop_on_copy&format=rss).

## Registro de cambios

#### 1.0.5

 * Added configurable gap/spacing between posts in classic, cards, and images layouts
 * New «Card Gap» setting in admin (Settings  BlueFeed  Layout & Spacing)
 * New `gap` shortcode parameter to override spacing per-shortcode (e.g. `[bluefeed
   layout="cards" gap="24"]`)
 * Each layout retains its own default spacing when no gap is set (Classic: 12px,
   Cards: 16px, Images: 4px)
 * Added configurable border radius for all card/post elements
 * New «Border Radius» setting in admin (Settings  BlueFeed  Layout & Spacing)
 * New `border_radius` shortcode parameter (e.g. `[bluefeed border_radius="0"]` 
   for square corners)
 * Added configurable border width for all card/post/divider borders
 * New «Border Width» setting in admin (Settings  BlueFeed  Layout & Spacing)
 * New `border_width` shortcode parameter (default: 1px, images layout defaults 
   to 0)
 * URLs, @mentions, and #hashtags are now clickable in the profile bio
 * Added #hashtag linking in post text — links to Bluesky hashtag search
 * URLs in posts and bio now display without the http/https prefix for cleaner appearance
 * Layout & Spacing settings moved to their own admin section with a dedicated reset
   button
 * Fixed compact layout hover background bleeding outside rounded corners on first
   and last rows
 * Fixed card image radius gap when using larger border widths
 * Fixed double line-break spacing in profile bio when URLs or domains are present

#### 1.0.4

 * Added «View Details» link on the Plugins page that opens the WordPress.org plugin
   information modal

#### 1.0.3

 * Added External services section to readme for third-party API disclosure compliance

#### 1.0.2

 * Moved admin settings page CSS and JS from inline to separate enqueued files for
   better performance and browser caching
 * Fixed copy-to-clipboard button showing both icons at the same time before being
   clicked

#### 1.0.1

 * Improved compact layout – tighter spacing, smaller avatars, and single-line flow
   for name and time on both desktop and mobile
 * Fixed copy-to-clipboard icons missing on the admin settings page (SVGs were stripped
   by wp_kses_post)

#### 1.0.0

 * Initial release
 * Four layout styles: classic, cards, compact, images
 * Profile header with stats
 * Caching system
 * Public API integration

## Meta

 *  Versión **1.0.5**
 *  Última actualización **hace 1 semana**
 *  Instalaciones activas **10+**
 *  Versión de WordPress ** 5.8 o superior **
 *  Probado hasta **6.9.4**
 *  Versión de PHP ** 7.4 o superior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/bluefeed/)
 * Etiquetas:
 * [bluesky](https://es.wordpress.org/plugins/tags/bluesky/)[feed](https://es.wordpress.org/plugins/tags/feed/)
   [Instagram grid](https://es.wordpress.org/plugins/tags/instagram-grid/)[shortcode](https://es.wordpress.org/plugins/tags/shortcode/)
   [social media](https://es.wordpress.org/plugins/tags/social-media/)
 *  [Vista avanzada](https://es.wordpress.org/plugins/bluefeed/advanced/)

## Valoraciones

Aún no se han enviado valoraciones.

[Your review](https://wordpress.org/support/plugin/bluefeed/reviews/#new-post)

[Ver todas las valoraciones](https://wordpress.org/support/plugin/bluefeed/reviews/)

## Colaboradores

 *   [ Alex Hedström ](https://profiles.wordpress.org/alexhedstrom/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/bluefeed/)