Understand, I don’t like to b*tch. I updated to 2.2, the site broke, the client is screaming and I’m so mad I’m about to spit bullets.
If you make changes to the programming, awesome. BUT, you’ve GOT to update the documentation as well. I tweaked the templates to fit with my theme. When I updated, everything broke. Understood, I went about to clean stuff up.
Then, I noticed there is a BUNCH of new page template. Fine. Checked the documentation to find NO information AT all to get this fixed.
You have information on:
BD template Description
businessdirectory-main-page.tpl.php This template is called inside the page with the [ businessdirectory ] shortcode.
businessdirectory-listings.tpl.php This template is used when displaying a list of listings (for instance inside a category/tag page or in search results)
businessdirectory-excerpt.tpl.php This template is used when displaying the excerpt view of a listing.
businessdirectory-listing.tpl.php This template is used when displaying a single listing.
OK..great. But look how many NEW templates you have:
[Image Can Not Be Found]
This is incredibly frustrating as I’ve got to fix this blind…
Of course, I try to update the post and it crashes. Love that.
Here is a screenshot of all the NEW templates you have and most do not have documentation. Causing me to be not nice:
I’m really sorry that I wasn’t nice, but geez this is frustrating.
My apologies for any problems you are running into. If you are upgrading from something fairly old, you may be running into issues. We had some threads about these when we released those changes and for the most part, we got people past them (as many as I was aware of). The change to 2.2 is not a big one, if you’re coming from 188.8.131.52. If you’re coming from 1.0 or even 2.0, that’s a different story. We made a big change awhile back (mid-last year?) to shift from sole template integration to use a natural theme-based integration to avoid many of the issues you used to have to custom-code around. That shift was difficult for some, but the big change is that you don’t want to use the OLD template overrides anymore. The old templates are the cause of 90% of the upgrade issues.
Short answer: Remove your OLD template overrides in the theme directory and try it out. You may find that you have very little work to do after that! That’s been the consensus from many users who upgraded AFTER the initial shock.
We are working on the documentation as a whole and we will improve it shortly–adding features and fixing bugs have taken priority to date.
As to the templates, the ones you should be overriding have been documented as you note above. Not all templates should be overridden and therefore, some templates will remain intentionally undocumented. We have a number of new templates we use but they are for internal use only and can’t be shifted to the theme directory for overrides. The documentation in this area is absolutely up to date and correct.
The reason for not documenting all templates is this: Some templates MUST have certain code and MUST be used in a certain way to maintain the features and functionality of the plugin. We’ve provided hooks where appropriate, but allowing global overrides of all templates will most likely cause odd and improper behavior of the plugin, so we have to restrict it for those who are not WP and PHP experts. And here, I really do mean expert because it’s too easy to make the plugin behave badly otherwise.
Most Users Ever Online: 211
Currently Browsing this Page:
Guest Posters: 5167
Newest Members:[email protected]
Moderators: BD Support: 2
Administrators: Business Directory Support: 1719