See: https://wordpress.org/support/topic/bug-when-user-does-not-have-permission-to-access-page/

When a logged-in user does not have permission to view the admin dashboard and visits /wp-admin/ the following errors occur:

[30-Mar-2020 11:36:28 UTC] PHP Notice: Trying to get property ‘cap’ of non-object in /var/www/wordpress/wp-content/plugins/wp-help/classes/plugin.php on line 211
[30-Mar-2020 11:36:28 UTC] PHP Stack trace:
[30-Mar-2020 11:36:28 UTC] PHP 1. {main}() /var/www/wordpress/wp-admin/index.php:0
[30-Mar-2020 11:36:28 UTC] PHP 2. require_once() /var/www/wordpress/wp-admin/index.php:10
[30-Mar-2020 11:36:28 UTC] PHP 3. require() /var/www/wordpress/wp-admin/admin.php:153
[30-Mar-2020 11:36:28 UTC] PHP 4. require_once() /var/www/wordpress/wp-admin/menu.php:326
[30-Mar-2020 11:36:28 UTC] PHP 5. do_action() /var/www/wordpress/wp-admin/includes/menu.php:155
[30-Mar-2020 11:36:28 UTC] PHP 6. WP_Hook->do_action() /var/www/wordpress/wp-includes/plugin.php:478
[30-Mar-2020 11:36:28 UTC] PHP 7. WP_Hook->apply_filters() /var/www/wordpress/wp-includes/class-wp-hook.php:312
[30-Mar-2020 11:36:28 UTC] PHP 8. CWS_WP_Help_Plugin->admin_menu() /var/www/wordpress/wp-includes/class-wp-hook.php:288
[30-Mar-2020 11:36:28 UTC] PHP 9. CWS_WP_Help_Plugin->get_cap() /var/www/wordpress/wp-content/plugins/wp-help/classes/plugin.php:601
[30-Mar-2020 11:36:28 UTC] PHP Notice: Trying to get property ‘read_posts’ of non-object in /var/www/wordpress/wp-content/plugins/wp-help/classes/plugin.php on line 211
[30-Mar-2020 11:36:28 UTC] PHP Stack trace:
[30-Mar-2020 11:36:28 UTC] PHP 1. {main}() /var/www/wordpress/wp-admin/index.php:0
[30-Mar-2020 11:36:28 UTC] PHP 2. require_once() /var/www/wordpress/wp-admin/index.php:10
[30-Mar-2020 11:36:28 UTC] PHP 3. require() /var/www/wordpress/wp-admin/admin.php:153
[30-Mar-2020 11:36:28 UTC] PHP 4. require_once() /var/www/wordpress/wp-admin/menu.php:326
[30-Mar-2020 11:36:28 UTC] PHP 5. do_action() /var/www/wordpress/wp-admin/includes/menu.php:155
[30-Mar-2020 11:36:28 UTC] PHP 6. WP_Hook->do_action() /var/www/wordpress/wp-includes/plugin.php:478
[30-Mar-2020 11:36:28 UTC] PHP 7. WP_Hook->apply_filters() /var/www/wordpress/wp-includes/class-wp-hook.php:312
[30-Mar-2020 11:36:28 UTC] PHP 8. CWS_WP_Help_Plugin->admin_menu() /var/www/wordpress/wp-includes/class-wp-hook.php:288
[30-Mar-2020 11:36:28 UTC] PHP 9. CWS_WP_Help_Plugin->get_cap() /var/www/wordpress/wp-content/plugins/wp-help/classes/plugin.php:601

I am more than happy to fix this if you would like. Would it be possible to port the source code to github though, and I can submit a pull request?

I can confirm.

Steps

1. Click "Add New" button within the WP Help listing navigation

2. Click the "Add Media" button

3. Upload a sample video

4. Click the "Insert into Page" button

5. Publish the help topic.

6. Navigate to the "Publishing Help" section

7. Click the newly added help topic – notice the video appears after the the WP Help listing navigation

On small screens, the navigation does not change it's layout and therefore the documentation gets squished:

A posibility to simply get the URL to the WP-HELP-Pages because this varies depending to the menu location of wp-help. E.g. by providing a public function or var to use in Plugins.

The plugin already requires WordPress 4.9 which makes it possible to omit some header fields and the load_plugin_textdomain() call. The translations can also be removed in favour of language packs based on https://translate.wordpress.org/projects/wp-plugins/wp-help/.

See also

• https://developer.wordpress.org/plugins/internationalization/how-to-internationalize-your-plugin/#text-domains
• https://developer.wordpress.org/plugins/internationalization/how-to-internationalize-your-plugin/#domain-path
• https://developer.wordpress.org/plugins/internationalization/how-to-internationalize-your-plugin/#loading-text-domain

I have a PULL request that addresses this issue, and will link it shortly.
(This ticket is to supply the background information).

I was seeing errors on my site generated from /wp-cron , related to wp-help.
The error was actually occurring in a different plugin (wp-optimise), however the cause of the error is able to be isolated to wp-help. This is illustrated in lines 6 & 7 in the trace below.
The error is thrown during CWS_WP_Help_Plugin::api_slurp() , when updating posts (i.e. slurped from another URL).

Currently, when CWS_WP_Help_Plugin::api_slurp() is called, it never registers the wp-help post type.

Reasons why I think the post type should be registered as part of api_slurp:

• It's a one-line code fix to solve.
• For someone encountering the error, it's not necessarily easy to diagnose.
• Given we're in the context of WP hooks...etc. it is perfectly reasonable for other plugins to expect that this post type be registered, prior to wp_update_post() being called.

TRACE is as follows:

ERROR: PHP E_NOTICE (#8): Trying to get property of non-object
# 0: /htdocs/wp-content/plugins/wp-optimize/cache/class-wpo-cache-rules.php (106): MyCustomErrorHandler()
# 1: /htdocs/wp-includes/class-wp-hook.php (289): WPO_Cache_Rules::purge_post_on_update()
# 2: /htdocs/wp-includes/class-wp-hook.php (311): WP_Hook::apply_filters()
# 3: /htdocs/wp-includes/plugin.php (478): WP_Hook::do_action()
# 4: /htdocs/wp-includes/post.php (4260): do_action()
# 5: /htdocs/wp-includes/post.php (4354): wp_insert_post()
# 6: /htdocs/wp-content/plugins/wp-help/classes/plugin.php (362): wp_update_post()
# 7: /htdocs/wp-includes/class-wp-hook.php (287): CWS_WP_Help_Plugin::api_slurp()
# 8: /htdocs/wp-includes/class-wp-hook.php (311): WP_Hook::apply_filters()
# 9: /htdocs/wp-includes/plugin.php (544): WP_Hook::do_action()
#10: /htdocs/wp-cron.php (138): do_action_ref_array()

I ran into a new problem today that I've never seen. On a synced help document, a majority of the content was removed. After a bunch of experimentation, I narrowed it down to an issue with the link replacement during the slurp process. I was unable to see exactly what content was creating the issue and in a rush, so for now, I simply removed all links to other help pages on that page to solve the issue. However, I hope to figure out more later, and I want to post this here in case other people have had similar issues.

Related:

• https://wordpress.org/support/topic/sync-pull-breaking-at-links/ (My example also had internal links, through removing them didn't seem to resolve the problem.)

Have you considered adding some search UI, so a user can search across all of their help documentation? Would you consider a pull request for this?

Seeing this PHP message after upgrading to v1.7.0 :
Strict Standards: CWS_WP_Help_Plugin and WP_Help_Plugin_Structure define the same property ($instance) in the composition of CWS_WP_Help_Plugin. This might be incompatible, to improve maintainability consider using accessor methods in traits instead. Class was composed in /htdocs/wp-content/plugins/wp-help/classes/plugin.php on line 721

Additional info;

• Running PHP 5.6 (and will be upgrading to PHP 7.x, before end of year).
• i.e. Possibly only affects older PHP ?

Thought this was a great idea posted in the support forums. Adding it here:

I would like to add a feature request on making the WP Help custom post type use relative links. That way it will be much easier to port the Help documentation of one site to another site.

I use a lot of links to admin pages in my site documentation and even when I add the link like for example /wp-admin/post-new.php?post_type=page, the export file still makes an absolute URL of it.

I have been looking through the code, but have not been able to make a filter like content_save_pre work.

I've run into this issue too, and this would be great.

I made some quick plugin icons.

They're very basic (only took me a minute). If you don't like them, feel free to close this issue (no hard feelings!). I just thought that they would look nicer than the auto-generated texture on WP.org.

Cheers,
Daniel

icon-128x128.png:

icon-256x256.png:

icon.svg:

Multilingual external source would be very handy for multisite.

I love this plugin but have always felt the text is harder to read than it should be. I'd really love to make a pass at improving the styles. While I'm not sure the plugin needs to be completely Gutenbergified, I do think that looking at their default typography might be a good place to start. If I were to work on this, that's probably where I'd start.

It seems there isn't much activity around here these days and there are a number of outstanding PRs, so @markjaquith I'd appreciate some feedback/ideas/go-ahead before sinking much time into working on some styles.

With the switch to WordPress 3.8 and the default dark color scheme, the plugin's menu icon no longer works. The plugin should switch to a font-based icon. Either a "?" or the equivalent symbol from Dashicons (content: "\f223";) makes sense.

This CSS adds the dashicon:

.toplevel_page_wp-help-documents .wp-menu-image:before {
    content: "\f223";
}

Such a switch would also require removing the current icon from the add_menu_icon() call that adds the Publishing Help admin menu item.

The plugin could maintain backwards compatibility by either only added the icon to the menu in 3.8+ or loading the Dashicon font in <3.8.

I use your plugin and it works well.
On one website, I have set some specific roles.
I have a group set to (on pages) : edit_pages / edit_published_pages / edit_other_pages It's strange but members of this group can edit help documents, even though they have no rights to publish_pages. Could you explain that to me?
And, do you think there is a way to prevent members of this group to edit the help documents ?
Thanks a lot!

Now that you can use the block editor to write documentation we need to make sure that the blocks are also styled. Core does this with wp_common_block_scripts_and_styles().

It seems like at least wp_enqueue_style( 'wp-block-library' ) and do_action( 'enqueue_block_assets' ); should be called on the documentation pages.

Since documentation can often become stale, it would be great to display these dates.

Without being familiar with how the sync feature works, I don't know if that would interfere in adding these (i.e. do sync posts share both the Publication and Updated dates?).

Superfan. Could easily spin up a CPT for this purpose, but I really love WP-Help and would love an update to Gutenberg, which would also make it current (it hasn't been updated in 2 years so its off the repo).

please @markjaquith pleaseeeeee :)

I haven't had a chance to dig into this, but I'm getting the following notice when editing a help doc with the block editor in the latest WP (5.3) & WP Help (1.7.0):

Notice: Trying to get property 'id' of non-object in /wp-content/plugins/wp-help/classes/plugin.php on line 107

I love WP Help and use it quite often, but it hasn't been updated in 2 years and that's a bit concerning. It still works, but is anyone keeping an eye on things regarding security or capability? It's just nice to know if someone is at least paying attention.

The plugin already removes the editor stylesheet from Twenty Twenty but there's no easy way to extend that for custom themes. By adding an action themes and plugin can use this to (de)enqueue additional scripts/styles.

The label should be made translatable with wp.i18n.

The plugin is awesome, nevertheless I think that responsive images and a lightbox are a must. For example, adding the following to the CSS would solve the responsive-images:

.wp-caption { max-width: 100%; }

.wp-caption img[class*="wp-image-"] {
    display: block;
    height: auto;
    margin: 0;
    max-width: 100%;
}