Description

Easily display FetLife events, groups, and more on your blog by adding widgets to your theme and using shortcodes in your posts, or pages. This plugin is very lightweight. Just log in to FetLife as you normally do from the plugin settings screen. Once that’s done, a built-in plugin cache automatically speeds up all future requests to FetLife.com.

Widgets and shortcodes

This single plugin provides a bunch of different add-ons for your WordPress blog.

Widgets

WP-FetLife adds numerous widgets that work well with any theme. See the Screenshots section for screenshots of some of these examples. Some of the Widgets this plugin provides are:

• FetLife Profile – Events
  • This widget shows the name of and links to any upcoming FetLife events on a FetLife profile page. Choose from events that the given user profile is “organizing,” “going to” or “maybe going to,” along with how many events to show, and more.
• FetLife Profile – Groups
  • This widget shows the name of and links to any FetLife groups a user belongs. Similarly, you can customize the widget to show only those groups the FetLife user is “leading,” how many groups to show in the widget, and more.
• FetLife Events – Participants
  • This widget displays the RSVP list for a FetLife event. Choose to show “going” or “maybe going” RSVPs, or both!

Every widget provided by this plugin is also available as a shortcode. Use the [wp_fetlife_widget WIDGET_NAME] shortcode to call a particular widget. You can even set its options right from the shortcode. For example, this shortcode displays the events that FetLife user number 1 is organizing:

[wp_fetlife_widget profile_events fl_id="1" show_events_organizing]

(The FetLife user number for a given profile is the number at the end of the web address for that user’s profile page. So, for instance, https://fetlife.com/users/1 is the profile page for user number 1.)

To display all upcoming events that FetLife user 1 is participating in, use:

[wp_fetlife_widget profile_events fl_id="1" show_events_organizing show_events_going show_events_maybe_going]

Similarly, the following shortcode shows all of user 1‘s groups:

[wp_fetlife_widget profile_groups fl_id="1"]

Or, show only the groups for which this user is the leader:

[wp_fetlife_widget profile_groups fl_id="1" show_only_groups_lead]

Some widgets (like these examples) require the fl_id parameter. Other parameters are optional and can be included as additional attribute values or omited to use the defaults. For example, to add a headline to the output of any of the above widgets, use the title attribute:

[wp_fetlife_widget profile_groups title="Join one of my FetLife groups!" show_only_groups_lead]

For a complete reference of feature additions, shortcode syntax, and so on, see Other notes.

Related tools

To export your FetLife content (Writings, etc.) and import them to your website as native WordPress content (blog Posts, etc.), use this plugin’s sister plugin, WP FetLife Importer.

Have your own ideas widgets or other features? Share it with the developer and other users in the support forum. 🙂
If you like this plugin, please consider making a donation for your use of the plugin, purchasing one of Meitar’s web development books or, better yet, contributing directly to Meitar’s Cyberbusking fund. (Publishing royalties ain’t exactly the lucrative income it used to be, y’know?) Your support is appreciated!

Widgets

The widgets this plugin provides are:

Profile widgets

The following widgets display information from a given user’s FetLife profile page.

• FetLife Profile – Events – Displays upcoming FetLife events shown on a FetLife profile page in a list. As a shortcode:
  • [wp_fetlife_widget profile_events fl_id=""]
  • show_events_organizing – Whether to include events the user is organizing in the output. (Default: false.)
  • show_events_going – Whether to include events the user RSVP’ed “I’m going” in the output. (Default: false.)
  • show_events_maybe_going – Whether to include events the user RSVP’ed “I’m maybe going” in the output. (Default: false.)
• FetLife Profile – Groups – Displays the FetLife groups a user belongs to in a list. As a shortcode:
  • [wp_fetlife_widget profile_groups fl_id=""]
  • show_only_groups_lead – Restrict the output to only those groups being lead by the given user.

Event widgets

• FetLife Event – Participants – Displays the RSVPs for a FetLife event in a list.
  • [wp_fetlife_widget event_participants fl_id=""]
  • show_organizer – Whether to include the event’s organizer in the output.
  • show_going – Whether to include the users who have RSVP’ed “going” in the output.
  • show_maybe_going – Whether to include the users who have RSVP’ed “maybe_going” in the output.

Each widget can accept the following additional optional parameters:

• clear_cache – Disables the built-in plugin cache for this shortcode. Using this attribute is not recommended, except for debugging purposes, as it will significantly slow down your website. (Default: false.)
• length – How many items to output. For example, to list the first ten groups for user 1, use: [wp_fetlife_widget profile_groups fl_id="1" length="10"]. (Default: 5.)
• title – A headline to include before other output. (Default: none.)