Improve onboarding experience

[dingman]

I'm having trouble getting the plugin to actually run. I tried CLI, but produces an error. I can't find anything in the Settings area that would allow me to run it. I also tried "updating" a post, but didn't run. The credentials are valid.

Help :)

[jeffpaul]

@dingman welcome to ClassifAI, apologies that you're having trouble getting it to work for you, hopefully we can get those resolved quickly.

In terms of getting the plugin to run, can you confirm that you've either set up Language Processing (via IBM Watson) or set up Image Processing (via Microsoft Azure) using the linked set up instructions on GitHub?

The CLI command to bulk edit posts will likely only work on ClassifAI v1.3.2 as prior versions were not properly registered with WP-CLI. If you're on v1.3.2, can you confirm which command you're using and the error being output?

For the Language Processing, can you confirm that "Posts" is checked in "Post Types to Classify" and what is selected for the "Category", "Keyword", "Entity", and "Concept" settings (e.g., yourdomain.com/wp-admin/admin.php?page=language_processing)? Confirming those will help me best replicate your setup to see if I can determine why you're not seeing tags being applied.

[dingman]

@jeffpaul Hey Jeff, thanks for jumping in.

Yes, I have Language Processing setup with IBM Watson. The credentials are valid.

WP CLI often returns an error, so it may not be installed properly onto our server. Is that a hard requirement for this plugin to work, to have WP CLI installed?

Confirmed that yes, Posts is checked, and I have Keyword enabled and "Tag" selected as the Taxonomy.

We often have things scheduled and posted automatically based on a schedule, maybe it has something to do with how the content is being published once it's ready to go live.

[jeffpaul]

@dingman you do not need to have WP CLI installed for ClassifAI to function. The WP CLI commands are provided to allow folks a way to batch-classify their content.

In terms of Watson not adding Keywords into Tags, can you reduce the Keyword Threshold (%) from 70 to something lower and test again? In all my testing I've noticed that I need to fine tune the various thresholds to get a good balance between actual data and valid data from Watson.

[dingman]

I will try that soon. How can I trigger the plugin to start processing again?

On Tue, Jul 30, 2019 at 7:55 PM Jeffrey Paul ***@***.***> wrote: @dingman <https://github.com/dingman> you do not need to have WP CLI installed for ClassifAI to function. The WP CLI commands are provided to allow folks a way to batch-classify their content. In terms of Watson not adding Keywords into Tags, can you reduce the Keyword Threshold (%) from 70 to something lower and test again? In all my testing I've noticed that I need to fine tune the various thresholds to get a good balance between actual data and valid data from Watson. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#109?email_source=notifications&email_token=AAOSV2YZZKSUJEZFA6NKOF3QCDPHDA5CNFSM4IHK6IZ2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD3FXK3I#issuecomment-516650349>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAOSV2Z2QCT2KQ622LSLZYTQCDPHDANCNFSM4IHK6IZQ> .

-- Thanks, Jon

[jeffpaul]

@dingman adding or updating a Post should have ClassifAI process Watson's Keywords into your Tags.

[jeffpaul]

@dingman as you and I discussed outside this GitHub issue, I'm updating this issue to more precisely "improve the onboarding experience". I'll also work on opening separate issues for the other topics we discussed, thanks again for the chat!

[jeffpaul]

Is your enhancement related to a problem? Please describe.
The following are some notes I captured from a discussion with @dingman related to improving the onboarding experience.

Describe the solution you'd like

• define what Categories, Keywords, Concepts, and Entities mean within the Language Processing / Watson setup
• note that you can utilize the Posts / Pages table list view's Screen Options to view the additional Watson * columns of data from Language Processing
• either include links to docs for walking thru the Watson API/key setup process or have better documentation inline

Designs
n/a

Describe alternatives you've considered
none

Additional context
none

[jeffpaul]

With no open PR for this and the fact that we're targeting v1.5 tomorrow, I'm going to punt this to v1.6 in hopes we can get this docs and setup flow update done then.

[jeffpaul]

I'd like to see #239 in the README.md doc for a bit before we try and pull any of this into to plugin settings screens. Let's see if the improvements in version 1.6.0 and these README.md updates help, and if not we can look to spend more time in version 1.7.0 on adding more context to the settings screens.