-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
134 lines (81 loc) · 6.94 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
=== WZ Followed Posts - Display what visitors are reading ===
Tags: followed posts, related posts, where did they go from here
Contributors: Ajay, webberzone
Donate link: https://ajaydsouza.com/donate/
Stable tag: 3.1.0
Requires at least: 5.6
Requires PHP: 7.2
Tested up to: 6.3
License: GPLv2 or later
Show "Readers who viewed this page, also viewed" a.k.a. followed posts on your page. Much like Amazon.com's product pages.
== Description ==
Have you seen Amazon's product pages? Amazon is a great example of visitor retention through recommendations. All of Amazon's pages have a "Customers who viewed this item also viewed". And how many times have you clicked those links? I know I have!
Now you can implement the same feature on your WordPress blog. **WebberZone Followed Posts** let's you show "Readers who viewed this page, also viewed" links on your page.
The plugin tracks the pages, posts and custom post types that visitors click through from the current post. You can then display these followed posts automatically at the bottom of your posts, using a shortcode or via the inbuilt widget.
__If you're looking for a plugin that displays posts related to the content, look no further than [Contextual Related Posts](https://wordpress.org/plugins/contextual-related-posts/).__
= Key features =
* **Automatic**: The plugin will start displaying visited posts on your posts and pages automatically after the content when you activate the plugin
* **Block editor support**: Easy to use block for the block editor. Find it under widgets or using "followed posts" or "where did they go from here"
* **Shortcode**: Use `[wherego]` to display the followed posts
* **Multi-Widget support**: Find the __Followed posts__ widget to display the posts in your theme's sidebar or any other area that supports widgets. You can use the widget multiple times with different settings for each
* **Manual install**: Want more control over placement? Check the [FAQ](https://wordpress.org/plugins/where-did-they-go-from-here/#faq) on which functions are available for manual install
* **Exclusions**: Exclude select posts and pages from the list of posts. Exclude posts from select categories from the list of posts
* **Supports all post types**: The visited posts list lets you include posts, pages, attachments or any other custom post type!
* **Styles**: The output is wrapped in CSS classes which allows you to easily style the list. You can enter your custom CSS styles from within WordPress Admin area
* **Customizable and extendable**: Extendable via filters and actions. Style with CSS or use the inbuilt plugin API
* **Thumbnail support**: Display thumbnails as well as text. The plugin tries multiple methods to fetch a thumbnail or you can even specify a default one
== Installation ==
= WordPress install =
1. Navigate to Plugins within your WordPress Admin Area
2. Click "Add new" and in the search box enter "WebberZone Followed Posts"
3. Find the plugin in the list (usually the first result) and click "Install Now"
= Manual install =
1. Download the plugin
2. Extract the contents of where-did-they-go-from-here.zip to wp-content/plugins/ folder. You should get a folder called where-did-they-go-from-here.
3. Activate the Plugin in WP-Admin.
4. Go to **Settings » Followed Posts** to configure
== Screenshots ==
1. Frontend view of the Followed Posts (Grid mode)
== Frequently Asked Questions ==
Check out the [FAQ on the plugin page](https://wordpress.org/plugins/where-did-they-go-from-here/#faq) for a detailed list of questions and answers.
If your question isn't listed there, please create a new post in the [WordPress.org support forum](https://wordpress.org/support/plugin/where-did-they-go-from-here). I monitor the forums on an ongoing basis. If you're looking for more advanced _paid_ support, please see [details here](https://webberzone.com/support/).
= How can I customise the output? =
Check out the settings page for a wide array of settings that let you customise the plugin output. You can also style the followed posts list using CSS. The following are the main classes that can be styled:
* **wherego_related**: CSS Class on all pages
* **wherego_thumb**: Class that is used for the thumbnail / post image
* **wherego_title**: Class that is used for the title / text
* **wherego_excerpt**: Class of the `span` tag for excerpt (if included)
You can add the CSS code in the **Custom Styles** section of the plugin settings page or in your theme's *style.css* file. To find out the detailed list of available styles, check out the HTML output of the generated code.
= Shortcode =
Use `[wfp]` to display the followed posts. This was changed in v3.1.0 from `[wherego]`. [Read more in this knowledge base article](https://webberzone.com/support/knowledgebase/followed-posts-shortcode/).
= Manual install =
**the_wfp()**
Use `<?php if ( function_exists( 'the_wfp' ) ) { the_wfp(); } ?>` to display the followed posts.
You can also use this function to display posts on any type of page generated by WordPress including homepage and archive pages.
== Changelog ==
= 3.1.0 =
Release post: [https://webberzone.com/announcements/followed-posts-v3-1-0/](https://webberzone.com/announcements/followed-posts-v3-1-0/)
Complete plugin rewrite to use classes and autoloading.
* Features
* New block for the block editor. Find it under widgets or using "followed posts" or "where did they go from here"
* New functions `get_wfp()` and `the_wfp()` replace `get_wherego()` and `echo_wherego()`. The latter two will throw deprecated notices
* New shortcode `[wfp]` replaces `[wherego]`. The latter will continue to work but it is recommended that you replace the shortcode
* New tools page can be found under Tools > WFP Tools. Import/Export settings and clear the cache from there
* Enhancements:
* Caching enabled by default - this will apply to new installs and if you reset the settings
* Bug fix:
* PHP warning if a post was not found
= 3.0.0 =
Release post: [https://webberzone.com/blog/followed-posts-v3-0-0/](https://webberzone.com/blog/followed-posts-v3-0-0/)
* Features:
* Support for PolyLang and WPML
* New options to stop tracking logged in users, authors, editors or admins
* Enhancements:
* Improved caching with inbuilt expiry. Use WFP_CACHE_TIME in your wp-config.php to set how long the cache should be set for. Default is one week. Setting it to `false` will disable expiry
* Upgraded post thumbnail handling: Select the thumbnail size. The plugin will also check for site icons before the default thumbnail is selected
* Upgraded settings to new Settings_API class
* Grid thumbnail style has been redone to use CSS grid and flexbox. Please pick the correct thumbnail size in the Thumbnail settings
For previous changelog entries check out the changelog.txt file included with the plugin or [view the releases on Github](https://github.com/WebberZone/where-did-they-go-from-here/releases).
== Upgrade Notice ==
= 3.1.0 =
New features and enhancements - view release post and changelog for full details.