- Download the plugin.
- Either use the “add new plugin” functionality internal to Wordpress.org in your “Plugins” menu or;
- Upload the plugin directory “affinitomics” to your /wp-content/plugins/ directory.
- Activate the plugin through the Plugins menu in WordPress.
- Go to “Aimojo™” in the left hand control menu.
- Select “settings” from the bottom of the list.
- Registering the plugin grants use of a valuable dashboard that allows users to view and manage Affinitomic Transactions
- Configure Affintomics™ for your site.
Configure Affinitomics
- Install the plugin
- In the admin panel, find the “Affinitomics” menu and select “settings”
- Next, under “To which Post-types would you like to apply your Affinitomics™?” check the boxes for the post-types you want to use with Affinitomics.
- Now scroll to the bottom and save changes. Unless you want to configure Google Custom Search (CSE) to work with Affinitomics, you’re done.
Optional Configuration for WooCommerce
aimojo short codes can show matches by category. WooCommerce has it’s own “product-category” so if you’d like to list it alongside any other post-type, you’ll want to add the following code snippet to your child theme’s functions.php
Code Snippet
Configure Google CSE integration
- In the admin panel, find the “aimojo” menu and select “Extensions” in the “JumpSearch” panel click on “Extension Settings”
- Ensure that the settings for the API URL, API Key, and API Account Domain are configured
- Ensure that the post types are selected
- Under “Jump Search select “yes” to apply the Google CSE “JumpSearch” to posts or pages
- Follow the links to obtain free API / Search credentials from Google.
NOTE: Existing pages and posts (rather, the Affinitomics placed on them) must be exported to the Affinitomics cloud before any of them will work.
- Under the Affinitomics menu choose “Export.”
- Check “Make it so.” This is a quick process, and is finished when the progress bar says "Done!"
- This will only have to be done once, unless you import pages or posts. It’s handled automatically for new pages, posts, and Archetypes.
Configure individual Posts, Pages, or Custom Post Types
- For existing pages or posts, either copy or move tags to the “Descriptors” field in the page or post editor.
- If you want like objects to attract like objects in your system, copy the tags to “Descriptors”.
- It is a best practice (not a requirement) to include a Descriptor of Person, Place, Thing, Concept or Construct in the Descriptors, especially if the Affinitomics are to be exported later, and shared.
- Draws can be immediately followed by a number from 1 to 5; the greater the draw, the greater the number. If there is no number, it’s value is considered to be “1”. Example; dogs5 is the highest preference for dogs possible.
- If a Distance is indicated, it is done in the same manner as a draw; dogs5. An attenuation of “5” indicates the highest possible dislike. If there is no number, it’s value is considered to be “1”.
- If none of the Affinitomic™ Element fields are filled in, the page, post, or custom post type will not be effected by Affinitomics™ - JumpSearch will have no effect, and only shortcodes with overriding Affinitomics™ will function.
Connect your similar pages with aimojo™!
- On a page that you would like to add a list of similar posts or pages, simply add the shortcode [afview]
- [afview] This tells Affinitomics to build a dynamic menu list. Without other parameters, it uses the affinitomics of the page it resides on to create a menu list of the top related items in the cloud.
- [afview display_title="false"] This was a result of a request to be able to hide the hard coded title.
- [afview title="title"] Replaces the default title with whatever you want.
- [afview category_filter="50"] or [afview category_filter="name"] This short code tells Affinitomics to build a menu list based on the Affinitomics of the page, but to restrict the list to a particular category.
- [afview limi="7"] This short code tells Affinitomics to build a menu with a limit of 7 links. Default is 6.
- To combine the parameters, simply separate with a space [afview limit=15 title="Nifty Stuff"]
Use the following class' to style [afview] display
- afview
- aftitle
- afsubtitle
- afelement
- afelementurl
- afelementscore