Connections

One of the planned updates for the next release of Connections is to improve the rich text editing of the Bio and Notes fields. Well, I’ve made great progress with that. Take a peek at the screen captures.

I’ve dropped jWYSIWYG for rich editing. Unfortunately it just isn’t robust enough and had some flaky behaviors across different browsers. In its place is tinyMCE, the same editor that WordPress uses but slimmed down, while still expanding the editing capabilities. Before you could only bold text, italicize text and add links. Those formatting options are still there but now also include underline text, numbered lists, bulleted lists and paragraph justification. You also can paste text as plain text, which is useful when pasting content from a webpage. And paste from Word, very useful for when pasting content in from Word as it removes all the proprietary mark-up. Last but not least, multiple level undo/redo.

The next release is coming along very nicely. Many new small feature have been added and well as coding optimizations which reduce the memory requirements. There is one major downside. This next update will break any custom templates that directly accessed the data for addresses, phone numbers, email addresses, websites and social networks. This was a tough choice as I’ve tried very hard not to break functionality implemented in past versions. But it had to be done in order to reduce the memory overhead and to allow more flexibility when creating templates in the future as I expand that feature set. The good news is that if you created a custom template an you stuck with the documented template tags you should have no problems. If you had paid me to create a custom template for you I will be more than happy to update your template free of charge. Other, you have my sincerest apologies for any issues this may cause you. Keep in mind you can simply revert to the previous version of the plug-in until you can update your template.

Some of the features that will highlight the next release…

A template tag to show the list a categories that an entry is associated with. A very highly requested feature. This will of course be added to the default templates.

An attribute can be added the shortcode to show all entries that where the post has the same categories. For example, if a post has been assigned to ‘Category A’ and ‘Category B’, the entries that have been assigned to both the same categories will be shown.

The category shortcode attribute will now accept a comma delimited list of category ids.

For theme developers, I’ve added two theme template tags. One for calling the entry list and the other to call the upcoming list. Both tags support all the shortcode attributes passed as an associative array. These two theme template tags definitely opens up all sorts of interesting things that can be done dynamically.

When, you might ask? My to do list grows smaller daily, so I would say in the next couple weeks if all goes well.

Connections is becoming more and more popular which great and I thank you! Here’s a peek at my development plans. Many of the features listed below are coming by popular demand. If all goes well the next release should be coming very soon.

Next Release => 0.7.0.0

• BUG: Set the db version after each db upgrade cycle.
• BUG: Add the missing social media block to the output class, default templates and help page.
• BUG: Fix typos in the help page.
• BUG: Fixed improper use of the prepare method when saving and updating entries.
• BUG: Fix issue causing the adding/editing of entries to fail when the ‘%’ character was used.
• BUG: Auto add the http:// to website and social media link URLs.
• BUG: Fix when copying or adding a Connection Group will display twice in the entry list. Caused by the group name being saved to the last_name field. Only save fields that pertain to the entry type selected.
• BUG: Database upgrade shouldn’t execute on a new plug-in install.
• BUG: Fix the filter and sort shortcode attributes to take into consideration the use of special characters like the apostrophe.
• BUG: Remove images from the server when being removed from an entry.
• BUG: Image tag should not be output in the image does not exist and the entry options should be updated.
• OTHER: Removed the use of $_SESSION throughout the plug-in.
• OTHER: Enhance plug-in security through the use of nonce.
• OTHER: Move the cnDate methods to the cnForm class.
• OTHER: Move the cnConvert methods to the cnFormatting class.
• OTHER: Require the class.upload.php class only when needed to remove 1.3MB in plug-in overhead.
• OTHER: Remove the known issue about WP Super Cache and images as they no longer apply.
• FEATURE: Add links for Setting, Help and Donate to the plug-in management page.
• FEATURE: Add template tag to display the categories that an entry is assigned to.
• FEATURE: Add honorable pre/suffice to entry form and hCard/vCard output.
• FEATURE: Add contact name for Organization entry type.

Release => 0.7.1.0

• FEATURE: Expand the category shortcode attribute to allow multiple category ids to be called. [Operational OR]
• FEATURE: Add in_category shortcode attribute. This will define multiple categories by id that an entry must be assigned in order to be displayed. [Operational AND]
• FEATURE: Add exclude_category shortcode attribute to allow multiple categories by id to be excluded from the output.
• FEATURE: Add category_name shortcake attribute to allow multiple categories to be called by name(/slug). [Operational OR]
• FEATURE: Add in_category_name shortcode attribute. This will define multiple categories by name(/slug) that an entry must be assigned in order to be displayed. [Operational AND]
• FEATURE: Add exclude_category_name shortcode attribute to allow multiple categories by name(/slug) entries to be excluded from the output.
• FEATURE: Add wp_current shortcode attribute to show entries based on the current category and in_category by name(/slug)
• FEATURE: Expand the RTE for the bio and notes fields to allow more styling

Release => 0.7.2.0

• FEATURE: Find and map WP users that are in Connections and maintain those relationships. To be used initially for the wp_current shortcode attribute to show and entry for the current post author or current logged in user. This will be useful for custom author / about me boxes and custom greeting based on the current user.
• FEATURE: Expand the wp_current shortcode attribute to show entries based on current tag/in_tag by name(/slug); author and user.
• FEATURE: Category list / drop down on the front end to allow users to filter based on category. Output will support permalinks via wp_rewrite.
• FEATURE: Add detail_template shortcode attribute. This is to support showing a second more detailed template of an entry. This will support permalinks via wp_rewrite.
• FEATURE: Add relation_template shortcode attribute. This is to support showing the details of an entry’s relationship. This will support permalinks via wp_rewrite.
• FEATURE: Expand the functionality of the template tags.
• FEATURE: Add support for custom CSS and JavaScript for templates. Only load the CSS/JavaScript on the page/post that the shortcode is called on.

A small percentage of users have been receiving this error. This error is caused because the host server is not configured correctly to use php sessions. I find this odd because in my fairly limited experience many web based applications absolutely require the php sessions. Since WordPress does not use php sessions I decided to rework the plug-in to remove it’s use. So if you are one of the few receiving this error, please download and install this version. Do keep in mind this version is under development an may contain bugs.

http://downloads.wordpress.org/plugin/connections.zip

If you do not want to use a development version see this FAQ for some possible solutions to fix this error.

http://connections-pro.com/?page_id=58#15

For all those who have been waiting for category support… it’s nearly here. Only a few more things to polish it off but if you would like to test it and give some feedback that would be great. Here the link and have fun.

http://downloads.wordpress.org/plugin/connections.zip

Oh, as always be safe and backup first.

UPDATE:

To show an entry list that displays a specific category add the following attribute where x equals the category id number. This will display the selected category and all the children categories.
The shortcode attribute is:

category=x

I’m finally in the home stretch… Here’s the to-do list for the next release:

• When adding or editing an entry and no categories are selected, assign the uncategorized category.
• When a category is deleted all term relationships should be deleted. If this removes all relationships for an entry then the uncategorized category should be set.
• Update term counts when a term is used.
• Make sure the Uncategorized category is created on activation if it doesn’t exist.
• Add an upgrade method to add the table columns needed.
• Add the category filter to the front/backend.
• Remove the role removal method from the from the deactivation hook.
• Add the uninstall hook to remove the plug-in options, users settings and role removal settings. MOVED TO NEXT RELEASE
• Add a restore default settings option. MOVED TO NEXT RELEASE
• Fix the token generation for connection groups. When editing an connection group entry, tokens should be created
• Rather than sequential numbering. And when viewing an entry list the token will overwrite if an entry appears individually and in a connection group causing a token mis-match error.
• Individuals in a connection group should only display the edit link in the current user has permission to edit that entry. Currently this result in an error.
• Check to see if an image exists before trying to display it. Also remove it from the entry’s options. MOVED TO NEXT RELEASE
• Add documentation for the public_overrride shortcode attribute to the help page.
• Add documentation for the category shortcode attribute.
• Update documentation for the id shortcode attribute.
• Add a filter to remove individuals from the list if they have been assigned to a connection group. MOVED TO NEXT RELEASE
• Set and check for supported image mime types. (jpeg, png, gif)
• Add social media links to output class and default templates. MOVED TO NEXT RELEASE
• Add a ‘name’ method to the output class to show the entry name determined by entry type. Remove this logic from the full name methods in the output class and update the default templates. NOTE: this will undoubtedly break some custom templates. MOVED TO NEXT RELEASE
• Finish the honorable pre/suffix drop down choices. MOVED TO NEXT RELEASE
• Add the honorable pre/suffix and middle name to the full name methods; both entry and output classes. MOVED TO NEXT RELEASE
• Add the contact name to both the entry and output classes. Update the default templates. MOVED TO NEXT RELEASE
• Update the vCard class to support the honorable pre/suffix and middle name additions. MOVED TO NEXT RELEASE

Well, unfortunately adding category support has taken way, way longer than I really wanted it to. I have the admin page completely finished. When I started working on the add entry form it became very clear that I would have to redesign it. In trying to accommodate so many field types the form has become very long and not everyone is going to need most of the available fields. So I decided to make the form more dynamic. Take a peek at the screen capture to see the progress. As you see on higher res screens, no more scrolling. Much better but it still needs more work.

Update - Add Entry Form

Adding category support to Connections is taking a bit longer than I originally anticipated do to the complexity. Don’t worry, it’ll be very easy to use! I’m nearly finished with the admin page. I’m just putting the polish on it. The next step will be to add the the interface to allow entries to be added to categories. How much longer, unfortunately I don’t think I’m going to be done until near the end of the month.

A picture is worth a thousand words…

Due to the nice rainy Saturday we just had it left we me with no choice but to spend some nice quality time working on the plug-in. Take a look at this screen shot. Yep, not only will there be category support, they’ll also be hierarchical. Good stuff!

Connections Category Admin Page

Almost finished with adding support for the honorable pre/suffix, middle name and social media IDs for an entry. I need to update the output class and hCard and vCard support to include these additions.  I have the UI for the category page and the creation of the supporting tables upon activation complete. The entry form has received a little love. You can now add an unlimited number of addresses, phone numbers, email addresses, messenger IDs and social media IDs. This makes the form much shorter and more versatile by adding only the fields you need on demand.