WordPress plugin for front end display of Codeable expert information
Stores expert and review information from the API in transients to lower number of server calls
- Expert Information (1 day)
- Reviews (4 hours)
[expert_reviews codeable_id=31044 number_to_pull=50 min_score=5 show_x_more=5 min_review_length=1 loading=lazy]
(stores 50 latest reviews, then shows the 5 most recent that have a score of 5 and at least some message with the review. Uses native Chrome lazyloading)
I've added 3 Gutenberg Blocks (picture, button, and reviews list), with all options from the shortcode below. These are still a work in progress! If you are so inclined to try them out, please let me know how they work for you. Keep an eye out for updates to these, as far as layout and structure.
| Shortcodes | Item to Insert |
|---|---|
| [expert_reviews codeable_id=31044] | shows reviews |
| [expert_image codeable_id=31044] | profile image |
| [expert_completed codeable_id=31044] | # of completed projects |
| [expert_rating codeable_id=31044] | average rating |
| [expert_hire codeable_id=31044] | button to hire |
- number_to_pull, defaults to 20, how many reviews to save from the api (can control how many show with show_x_more)
- show_title=yes to show task title, defaults to no
- show_date=yes to show review date, defaults to no
- show_rating=no to hide the rating (default is show)
- min_score, only shows reviews above and including this score (blank is no min)
- max_score, only shows reviews below and including this score (blank is no max)
- sort=rand, sorting options, valid value is just rand for now. Default is no sorting (profile page order)
- start_at (default 1), useful for chunking in offsets. (Does not work for now with random)
- show_x_more (default is show all), show the next x reviews (from offset if set, or from start).
- min_review_length (default is show all), number of characters minimum in review message to show the review. Set to 1 to hide blank reviews, or larger number to hide short reviews.
- has_picture, set to "yes" to hide all reviews that use the default profile image (may break if default no profile images switches, I will have to fix manually if so)
- filter_clients, comma seperated list of client IDs to exclude from display
- filter_reviews, comma seperated list of review IDs to exclude from display
- only_clients, comma serpated list of client IDs to exclusively display (other filters still apply)
- only_reviews, comma serpated list of review IDs to exclusively display (other filters still apply)
- schema=yes Enable structured data using json-ld (aggregate review, review markup) (yes to enable, only use this once per page for now)
- schema_desc="Your description here" (default is: Custom WordPress work through Codeable.io)
- start_time (unix timestamp, will only show reviews published after this time)
- end_time (unix timestamp, will only show reviews published before this time)
- loading (set value to lazy to lazy load natively for Chrome, default is none)
- cache (set value to "yes" to locally cache profile pictures, uses file_get_contents on first run, default is "no")
- circle=yes , default is yes shows image as a circle
- class=your-class , add a custom extra class to the image tag for easier styling
- loading (set value to lazy to lazy load natively for Chrome, default is none)
- name (set value to Codeable Expert's name for alt text, default is "Codeable Expert")
- cache (set value to "yes" to locally cache profile pictures, uses file_get_contents on first run, default is "no")
- message="Your Message", defaults to "Hire Me"
- referoo=xxxxxx, defaults to empty
- class=your-class, optional extra class to add to the link to make styling easier
- theme=black sets a button theme: valid values are black, white, or anything else for no theme (defaults to black)
- Blocks: Work out additional styling options / make them more useful
- Blocks: Build pre-formatted blocks combining shortcodes (number of tasks, picture, average) in a nice layout.
- Additional sort options
- Impliment a "default" expert ID, referoo code as plugin settings (still could be overwritten on a shortcode level)
- Continue to tweak and optimize code / display as needed
- Look at some sort of local caching of images to cut down on external calls to AWS
== Changelog ==
== 2.2.1 and 2.2.2 =
- Accessibility: Include Reviewer Name in Alt-Text for Profile Image
- Accessibility: Name Attribute for Expert Profile Image, used in Alt Text
- Bugfix: Fix folder structure error from 2.2.0
= 2.2.0 =
- Feature: Optional Local Caching of Remote Images (cache flag on reviews and expert profile image)
= 2.1.0 and 2.1.1 =
- Feature: GitHub Updates after this version no longer require GitHub Updater plugin
- Feature: Add lazy loading attribute to expert profile image and images in reviews. (set to lazy)
- Bugfix: Fix PHP warning for undefined variable in block
= 2.0.3 =
- Bugfix: Fixed issues caused by non-unique IDs in editor (toggles, lables)
= 2.0.1 & 2.0.2 =
- Rudimentary show / hide toggle for inputs on Review List block (2.0.1)
- Reviews list inputs hidden by default (2.0.2)
= 2.0.0 =
- Initial Gutenberg Update
- Added Review List, Expert Image, and Hire Button blocks (WIP)
= 1.5.0 =
- First version of schema / structured data (aggregate review, reviews): schema, schema_desc atts
- Added ability to filter displayed reviews by start_time and end_time (must be in Unix timestamp format)
= 1.4.1 =
- Added sanitizing of external data (esc_html / esc_url where appropriate)
= 1.4.0 =
- Additional review filtering options (filter out by client / review ID, or limit to ONLY client / review ID lists)
- Added additional classes to review li container, to better expose client ID and review ID to use with the above options.
= 1.3.0 =
- Greatly improved filtering using array_filter (now works with offsets)
- Increased default number to pull to 20
- Handled edge case where user tries to pull more reviews than they actually have
- Better commenting throughout plugin code
= 1.2.1 and 1.2.2 =
- Changed number_to_show to number_to_pull (nonbreaking change)
- Added show_rating=no att to reviews to hide rating / stars line
= 1.2 =
- Add start_at and show_x_more atts on reviews
- Additional filtering atts on reviews: min_review_length, has_picture
- Added changelog
= 1.1 =
- Add support for Github Updater
= 1.0 =
- Added max_score and min_score atts
- Clean up back-end code for saving reviews
- Add random sort option
- Styling fix on review stars
= 0.8 =
- Initial Plugin Release