=== WP4Labs ===
Contributors: Philipp Franck, Tim Greller
Donate link: -
Tags: users, academic
Requires at least: 3.1.0
Tested up to: 6.2.2
Stable tag: 1.7
Adds some lightweight features to manage scientific groups and users.
== Description ==
* Use Wordpress 3.1 - Older Versions will cause trouble
WP4Labs is a small Plugin, wich provides some functions to manange a lab or a scientific group. I designed it for the websites of two Biolabs. It's far away from being my first WP-Plugin, but it's the first one I want to publish. I tested it in four or five WP-installtions on dofferent servers, and it seems to all OK.
It provides the following parts:
- An advanced User Profile, containing some fields for academic career dates
- in connection with that a connection to the ariw.org-database of scientific institutions worldwide, to make it easier to find a specific institution and its URL
- the possibility to manage users in academic groups, such as Alumni, Post-Doc, P.I., and such (customizable)
- a local-avatar function that maintains the possibility for users to use a Gravatar (maybe someday I should take this one out and make a own plugin out of it)
- a post-type called 'project', to which you can connect users to (scientific) groups. Only users with P.I.-status (for being the leader of the group) can add or remove users.
A nice backend integration is built, I also ship some example templates to learn, how to integrate the provided functions to your theme.
== Installation ==
1) Install the plugin files.
2) To enable caching of ariw.org-files get the plugin's directory and give the WordPress writing rights for the folder 'ariw_cache' (777).
3) Go to the site's backend and add a project. Add some users to the project.
4) Build templates for your theme (see usage or example templates)
== Frequently Asked Questions ==
= Where is the advanced user profile? =
Build a new user. Save it. Now edit it. Now the new field should be visible.
= Ariw.org-Database is not reachable =
The plugin tries two ways of connecting to the Database. Under some circumstances, both fail due to the security settings of your server. In that case, I can't anything for you.
== Usage ==
For your template, build the following templates:
archive-biofoo_project.php - This gives an overview of the existing projects.
single-biofoo_project.php - Watch a single project.
Also, you can edit your author.php to display the additional information.
The plugin contains some useful functions for building these templates:
<user_object> = get_biofoo(<user_object>);
Throw a <user_object> from get_userinfo (not get_users!) or such into it, to get the advanced profile information.
Example:
<?php $user = get_biofoo(get_userdata($user_id));
?>
<?php if (($user->ba_degree or $user->ma_degree) or $user->phd_degree) : ?>
<h4><?php echo _e('Academic Degrees'); ?></h4>
<table class="user_info">
<?php if ($user->ba_degree) : ?><tr><td>B.A.</td><td><?php echo $user->ba_degree; ?></td></tr><?php endif; ?>
<?php if ($user->ma_degree) : ?><tr><td>M.A.</td><td><?php echo $user->ma_degree; ?></td></tr><?php endif; ?>
<?php if ($user->phd_degree) : ?><tr><td>Ph.D.</td><td><?php echo $user->phd_degree; ?></td></tr><?php endif; ?>
</table>
<?php endif; ?>
--------------------------
echo_project_members(<post_id>, <style>, <allgroups>)
Displays (or returns) all members of a project:
<post_id> INT or STRING
The Id of a post with type biofoo_project. Instead of a post_id, you may use the string keyword 'all' to get all users of the blog.
<style> STRING
Default: boxes.
Knows the following styles:
* 'longlist' -> All members below each other with avatar and academic information.
* 'boxes' -> Boxes with
* 'text' -> The names of all members in a line as clickable links.
* 'return' -> Displays nothing but returns an array with the members of the project.
<allgroups> BOOLEAN
Default: true
If set to false, users, which are in passive user groups like alumni are not displayed.
--------------------------
the_boss(<post_id>)
Displays the leading members (P.I.s) of a project.
--------------------------
function list_users_projects(<user_id>)
Displays a list of projects, a user is a member of.
== Screenshots ==
1. The advanced user profile
2. Adding a new Project
3. The frontend of a Project may look like this
4. The frontend of the user list may look like that
== Update Log ==
1.7
* Support for modern PHP versions (PHP 8)
* Improved listing of members
* Rework of the user group system and the distinction between alumni and active members
* Restrict access to wp-admin for alumni
* Improved profile picture settings
* Improved styling
1.5
* Renamed file and folder to wp4labs.