=== ProFeedWP – LinkedIn Company Feed Block & Shortcode ===
Contributors: accomplicehq
Tags: linkedin, linkedin feed, linkedin posts, linkedin company, company feed
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 1.6.10
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display a LinkedIn company feed in WordPress with a Gutenberg block or shortcode.

== Description ==

ProFeedWP lets you display your company's LinkedIn posts on any WordPress site without setting up a LinkedIn API app. Add a native Gutenberg block or shortcode, paste your LinkedIn company URL, choose a layout, and your feed is ready.

Feeds are cached locally for faster loading and better reliability.

Learn more at [ProFeedWP.com](https://profeedwp.com/).

See a live demo at [profeedwp.com/demo](https://profeedwp.com/demo/).

= Features =

- One LinkedIn company feed with up to 6 posts
- Responsive Gutenberg block
- Shortcode support for Classic Editor and popular page builders
- Grid and list layouts
- Default, Minimal, Barebone, and Social themes
- Basic styling controls for images, dates, text, columns, and image aspect ratio
- Automatic feed refresh about every 12 hours
- Local feed caching through WordPress transients

= Performance & Privacy =

Feed requests go through WordPress and are cached with transients, so repeated page views can use local feed data while it is fresh. When fresh data is needed, WordPress contacts the ProFeedWP API with the configured LinkedIn company URL and basic plugin/install metadata. Full external service details are listed below.

= ProFeed Pro =

The free ProFeed plugin is fully usable as a LinkedIn feed block and shortcode. Need more layouts, multiple feeds, faster refreshes, advanced styling, or agency workflows? ProFeed Pro adds more themes, custom colors, font sizing, border radius, spacing controls, and priority support.

View [Pro features](https://profeedwp.com/pricing/).

= Source Code =

The readable source for generated block assets is included in the `src/` directory. Build output in `build/` is generated with `npm run build` using `@wordpress/scripts`.

Swiper is bundled locally from the GPL-compatible npm package declared in `package.json`. Package source is available at https://www.npmjs.com/package/swiper.

== Installation ==

1. Upload the `profeed` folder to the `/wp-content/plugins/` directory, or install the ZIP via Plugins > Add New > Upload Plugin.
2. Activate the plugin through the Plugins menu in WordPress.
3. In the block editor, add the ProFeed block and configure its settings, or add the `[profeedwp]` shortcode in the Classic Editor, a page builder, a widget, or a template.

== Shortcode Usage ==

Use `[profeedwp]` when Gutenberg is unavailable or disabled. The shortcode works in the Classic Editor, Elementor, Divi, Avada, widgets, and templates that render WordPress shortcodes.

Full shortcode guide: [Use ProFeedWP with a shortcode](https://profeedwp.com/docs/use-profeedwp-with-a-shortcode/).

Basic example: [profeedwp company_url="https://www.linkedin.com/company/example/"]

Custom grid example: [profeedwp company_url="https://www.linkedin.com/company/example/" posts="6" theme="minimal" columns="3"]

List example: [profeedwp company_url="https://www.linkedin.com/company/example/" posts="6" layout="list" list_media_left="true"]

== Screenshots ==

1. Configure ProFeed inside the WordPress block editor.
2. Preview and adjust feed settings from the editor sidebar.
3. Display LinkedIn posts in a responsive masonry-style feed.
4. Add a LinkedIn feed section to a homepage or landing page.

== Frequently Asked Questions ==

= Do I need a LinkedIn API key? =

No. The plugin retrieves public company posts via the ProFeedWP external service and does not require you to configure LinkedIn API credentials.

= Does ProFeedWP work with Elementor, Divi, Avada, and Classic Editor? =

Yes. ProFeed includes a Gutenberg block and the `[profeedwp]` shortcode. The shortcode can be used in the Classic Editor, Avada, widgets, templates, and page builder modules that render WordPress shortcodes, including Elementor and Divi shortcode or text modules.

= Can I show LinkedIn Showcase Pages? =

ProFeed is built for LinkedIn company page URLs. LinkedIn Showcase Pages are not a separate supported feed type at the moment.

= Does it work with personal LinkedIn profiles? =

No. ProFeed is designed for public LinkedIn company pages, not personal LinkedIn profile feeds.

= Can I display multiple feeds on one site? =

The free plugin is designed for one LinkedIn company feed per site. If you need to manage multiple feeds or larger client and team setups, ProFeed Pro is the better fit.

= Does it slow down my website? =

Feed requests go through the local WordPress REST proxy and are cached with WordPress transients. Repeated page views can use cached feed data, so visitors are not repeatedly waiting on LinkedIn or the ProFeedWP API for every page load.

= Does the plugin cache feed responses locally? =

Yes. Feed requests are proxied through WordPress and cached with transients. Repeated requests can be served from the local cache while stale entries refresh in the background.

= What data is sent to ProFeedWP? =

When a feed loads or an administrator refreshes it, ProFeed sends the configured LinkedIn company URL, site URL, generated install ID, plugin version, requested page and page size options, requested engagement/comment options, and optional Freemius install/license identifiers when available. No LinkedIn API key is required from the site owner.

= What happens if LinkedIn is temporarily unavailable? =

If fresh data cannot be retrieved, ProFeed uses the local cache when available and shows a clear unavailable or no-posts message when no usable feed data is available. Temporary LinkedIn or API issues normally resolve when the cache refreshes again.

= Can I customize the design? =

Yes. The free plugin includes basic styling controls for grid/list layouts, themes, columns, images, dates, text, and image aspect ratio. ProFeed Pro adds more themes, custom colors, font sizing, border radius, spacing controls, and advanced layout options.

= What is included in the free version vs Pro? =

The free ProFeed plugin includes one LinkedIn company feed, up to 6 posts, grid/list layouts, block and shortcode support, local caching, Default/Minimal/Barebone/Social themes, image aspect ratio, and automatic refresh about every 12 hours. ProFeed Pro is a separate upgrade for more themes, multiple feeds, faster refreshes, agency use, advanced styling, and priority support.

View [Pro features](https://profeedwp.com/pricing/).

== External Services ==

ProFeed connects to external services to retrieve and display public LinkedIn company posts.

= ProFeedWP API =

ProFeed contacts `https://api.profeedwp.com` when a block, shortcode, or administrator-triggered refresh requests feed data. It sends the configured LinkedIn company URL, site URL, generated install ID, plugin version, page/page size options, requested engagement/comment options, and optional Freemius install/license identifiers when available. Responses are cached locally in WordPress transients.

Privacy policy: https://profeedwp.com/privacy-policy/

Terms: https://profeedwp.com/terms-and-conditions/

= LinkedIn public pages =

When additional public media information is needed, ProFeed may request public LinkedIn post or media URLs from `https://www.linkedin.com/` and `https://media.licdn.com/`. These requests send the public URL being resolved and a standard HTTP user agent.

Privacy policy: https://www.linkedin.com/legal/privacy-policy

Terms: https://www.linkedin.com/legal/user-agreement

= Freemius =

The bundled Freemius SDK connects to `https://freemius.com/` for optional account connection, software updates, license/account handling, opt-in flows, and related administrative actions. Freemius handles the site, user, plugin, license, and account information needed for those actions.

Privacy policy: https://freemius.com/privacy/

Terms: https://freemius.com/terms/

== Blocks ==

- profeedwp/profeedwp

== Changelog ==

= 1.6.10 =

- Fixed local REST requests on WordPress installs in a subdirectory.
- Fixed incorrect slideshows appearing on some shared-link posts.

= 1.6.9 =

- Updated the default ProFeedWP API endpoint to the branded `api.profeedwp.com` domain.

= 1.6.8 =

- Updated the free feature set to one feed, up to 6 posts, grid/list layouts, four themes, image aspect ratio, block and shortcode support, and automatic refresh about every 12 hours.
- Refined Pro upgrade messaging for layouts, multiple feeds, faster refreshes, advanced styling, and agency use.

= 1.6.7 =

- Added modest Pro feature links in the settings page and block editor for free installs.
- Improved WordPress.org title and search metadata.

= 1.6.6 =

- Improved manual refresh compatibility for WordPress.org review.
- Expanded external service disclosure for public package review.
- Simplified shortcode examples that depend on optional engagement fields.

= 1.6.5 =

- Updated public package metadata and external service disclosure for WordPress.org review.
- Standardized local feed cache timing for all installs.
- Replaced the shortcode guide URL with the public documentation page.

= 1.6.4 =

- Prepared the free package for WordPress.org review.
- Improved package compatibility checks, admin refresh handling, and public release metadata.

= 1.6.3 =

- Improved feed loading by serving the last cached feed immediately while stale cache refreshes in the background.
- Kept existing cached feed content available after manual refreshes so visitors do not wait for upstream refresh work.

= 1.6.2 =

- Improved admin refresh handling so refresh cooldown responses show a clear wait message.
- Kept the existing feed visible when refresh cooldown or temporary feed errors occur.
- Improved post media rendering for LinkedIn posts with multiple images.

= 1.6.0 =

- Added shortcode support for Classic Editor, Avada, widgets, and templates that run `do_shortcode`.
- Improved shortcode asset loading so frontend styles and scripts are available when no Gutenberg block is present.
- Added block compatibility for older saved content.

= 1.5.0 =

- Added the Social block style.
- Added support for backend-provided company avatars and media items.

= 1.4.25 =

- Updated free package metadata for WordPress.org compatibility.

= 1.4.24 =

- Improved LinkedIn company URL normalization in the local REST proxy.

= 1.4.23 =

- Improved compatibility for stored account data during package updates.

= 1.4.22 =

- Improved compatibility for existing account data during package updates.

= 1.4.21 =

- Improved LinkedIn URL handling, local feed caching, settings permissions, bundled assets, and external service disclosure.

= 1.3.7 =

- Security update.

== Upgrade Notice ==

= 1.6.10 =

Fixes local REST requests on subdirectory installs and incorrect slideshows on some shared-link posts.

= 1.6.9 =

Updates the default ProFeedWP API endpoint to the branded api.profeedwp.com domain.

= 1.6.8 =

Updates the free feature set and Pro upgrade messaging.

= 1.6.7 =

Adds modest Pro feature links and improves WordPress.org title and search metadata.

= 1.6.6 =

Improves manual refresh compatibility and public external service disclosure.

= 1.6.5 =

Updates public package metadata and external service disclosure for WordPress.org review.

= 1.6.4 =

WordPress.org preparation release with cleaner package behavior and public release metadata.

= 1.6.3 =

Serves stale feed cache immediately while refreshing in the background, reducing visitor wait time during cache refreshes.
