Creating an add-on "product type book" for ZC 1.5

Quote:

---

Originally Posted by hboswijk

I haven't had the time yet to take a look at the plugin, unfortunately. But about the ISBN:
- not all books have an ISBN!
- ISBN's may be printed wrong in the book
- some books have different cover-editions (but the same ISBN's)
So I think one needs an internal product or model number and a separate ISBN-field (useful extras: the handling of hyphens and a check on the number).

---

Yes, I think the need for an additional field for an internal ID is easy to see and something like this will be added for sure. Books that don't have an ISBN could use the ISBN field or separate field for ID. You can also decide to just leave the ISBN field empty and fill in only the book titles if that works for you. Books with different covers could simply have the same ISBN and different cover images, so no problem there either as far as I can see.

ISBN number validation will surely be implemented.

Actually, the "model no" is not used in all that many places in the ZC system and I now discover that some BookX specific info needs to be injected anyway in the shopping cart (e.g. "subtitle" of book). Therefore, an extra ISBN field separate from "model no." looks like it could work ok.

Cool. I wasn't saying that my customer uses Amazon's internal IDs. It was just an example of what another online store does with products that have ISBNs. They need to use their own internal id number for inventory. The model number field is treated just like the products_id field in osCommerce. It really is an ID field rather than a model number. They just couldn't call it id because they implemented an auto-increment field with that name for database rules.

So who's using this plugin? Remember, it's Feedbackware ;)
Tell us what kind of shop you are using it for e.g. publisher? Bookseller? Multi-language?, if you only sell books or other products as well. That helps me to get an idea what other user scenarios to keep in mind while developing this plugin.

I am close to relasing another version of the plugin, which will still be called BETA, but I find it's in fact rather stable. If anybody discovered bugs while using it, now is a good time to let me know.

Apart from ironing out some minor glitches, the new version will most notably allow searching for BookX attributes like authors, publishers, series, etc. via the ZC "search" sidebox. Furthermore it adds a separate listing of BookX attributes, like all authors, all series, etc.

Cheerio,
p.

OK, now I have taken some time to look at the plugin. It looks very nice already from a booksellers point of view. I can't judge the technical side.

Here are my observations:

1. I tried to add a dutch translation to the plugin, simply by copying the language files to a folder 'dutch' and translating some of the strings. But that does not function properly. On the storefront the only book I see is the one I added manually. The imported titles from the sample data file don't show up. On the admin side adding or editing a book in the dutch interface results in a blank page. In German and English it works OK. So obviously installing a translation needs something extra.

2. Importing the sample book data resulted in an error (this was before I installed a german language pack for Zencart), and then some of the fields were imported (title, description), others were not (authors, publishers were replaced by authors and publishers I had already entered). But maybe this was due to my messing around with the dutch translation. I will try a new clean install of it all to check this out.

3. The order of the custom fields is now: Attachment 12498 (Is this image visible?)
In text: Subtitle, Publishing date, Volume no., No. of pages, Size, Publisher, Series, Author(s), Binding.
A more logical order would be (certainly for me as a former librarian :smile:), including not yet available (nya) fields: Subtitle, Author(s), Edition (nya), Publisher, Publishing date, No. of pages, Size, Series, Volume no., Annotation (nya, could go in Description), ISBN (nya?), Keywords (nya).

4. The Publishing date field now requires a real date, but just a year will do fine, as day and month are normally unknown.

About the front:

5. I created some author types (main author, editor, illustrator, translator). In the product listing they don't show up in the right sorting order, and anyway just the main author would be enough there. (in Opera that is, in IE9 only the main author is shown ?)

6. In the single product view, part of the information is shown twice: once below the title, and once more under the description (publisher and authors).

7. The Book filters box in the sidebar shows information from the box above it, under the header, above the filters.
See: www.h b p r o j e c t e n.nl/hbwinkel

That's it for now.

Hi hboswijk,

thanks for your feedback.

Here some comments:

Quote:

---

Originally Posted by hboswijk

1. I tried to add a dutch translation to the plugin, simply by copying the language files to a folder 'dutch' and translating some of the strings. But that does not function properly. On the storefront the only book I see is the one I added manually. The imported titles from the sample data file don't show up. On the admin side adding or editing a book in the dutch interface results in a blank page. In German and English it works OK. So obviously installing a translation needs something extra.

---

I tried to duplicate your problem, but everything works here. I duplicated the "english" folders in "ADMIN/includes/languages/" and "CATALOG/inlcudes/languages/" and named the folders "dutch". I then created a new language called "Nederlands", folder name "dutch", language code "nl". Everything seems to wortk fine, my products show up and a new product with info in the "dutch" fields displays that info. I have changed some language files inside the folder "dutch" (BookX files) and if the frontend also is set to use "dutch" then it shows the modified labels. Maybe you can try the same approach and duplicate an existing folder, but surely there must be a dutch translation for ZenCart already? You probably don't want to translate the entire shop.

Quote:

---

Originally Posted by hboswijk

2. Importing the sample book data resulted in an error (this was before I installed a german language pack for Zencart), and then some of the fields were imported (title, description), others were not (authors, publishers were replaced by authors and publishers I had already entered). But maybe this was due to my messing around with the dutch translation. I will try a new clean install of it all to check this out.

---

I will look into that again, the sample data import has not received enough attention from me, since it was just a way to let me (and you!) test the installs without having to create books, authors, publishers etc. every time.

Quote:

---

Originally Posted by hboswijk

3. The order of the custom fields is now: Attachment 12498 (Is this image visible?)
In text: Subtitle, Publishing date, Volume no., No. of pages, Size, Publisher, Series, Author(s), Binding.
A more logical order would be (certainly for me as a former librarian :smile:), including not yet available (nya) fields: Subtitle, Author(s), Edition (nya), Publisher, Publishing date, No. of pages, Size, Series, Volume no., Annotation (nya, could go in Description), ISBN (nya?), Keywords (nya).

---

It will probably be difficult to find a solution that fits everybody. I wonder if it is critical enough to add a sort order mechanism or if that just makes everything too complicated. If you know just a little bit of HTML, then you can reorder the fields inside the "collect_info.php" file in the ADMIN. I could mark the start and end of a field entry with <!-- comments -->, so that it is clear what to move around?
Arguably, the Series and Volume No. have more to do with the Title and Subtitle of the book and should be close together?
ISBN is implemented in the upcoming release.
Could Keywords go into the product specific META TAG keywords? They would make sense there and it should be possible to add a way to include them in BookX searches or cross-references. What do you think about that?
I wouldn't have use for an "Edition" field, so in your scenario, does this have to be a free entry field for administrator text or could you also define a list of options to choose via pop-up? The way it is now, pop-ups e.g. for genres or publishers only show up on the "collect_info" page, when there are genres or publishers defined for BookX. This way, if a shop is not using them, they don't get in the way. If that were the same for "Edition" I could very well see adding this field.

Quote:

---

Originally Posted by hboswijk

4. The Publishing date field now requires a real date, but just a year will do fine, as day and month are normally unknown.

---

Good point. I will check out the Calendar plugin used by ZC, to see if a year & month only selection is working or if it needs to be entered by hand. Anyway, this should be working as you suggest.

Quote:

---

Originally Posted by hboswijk

About the front:
5. I created some author types (main author, editor, illustrator, translator). In the product listing they don't show up in the right sorting order, and anyway just the main author would be enough there. (in Opera that is, in IE9 only the main author is shown ?)

---

I will check to make sure sorting order is respected in the product listing view. To only show one and not the others will be tricky.
I will need to do something similar myself with "Series" and I am using custom code to only display sort orders smaller than say 1000. We could do something like that for product listing, or will it be confusing?

Quote:

---

Originally Posted by hboswijk

6. In the single product view, part of the information is shown twice: once below the title, and once more under the description (publisher and authors).

---

I think I know what you mean. The Product Info page was still very crude in the first BETA. I have polished it a bit, but it's not yet brilliant. Eventually it needs to look nice to go online, so we should have something that is accepatble for most users.

Quote:

---

Originally Posted by hboswijk

7. The Book filters box in the sidebar shows information from the box above it, under the header, above the filters.
See: www.hbprojecten.nl/hbwinkel

---

Since I took some time to respond to your post :-%, you seem to have changed your shop settings. In any case I don't see the problem you describe. However I remember that I did have a similar problem here a while ago (after release of first BETA) and I fixed it, so maybe that also resolves your issue.

I hope to get back onto this job quickly, but my attention has been diverted by another project, which puts some bread on the table ;-)

Best,
philou

Hi, you,
I used the beta 0.9 and I now wanted to correct with the last release 0.9.1 but there is no way to proceed to the update via admin>>tools.
is there any one who tried the same thing, and what's the come up ?
please help !

Hi habib_bou,

you discovered a bug in the installation script. It looks like the update script runs, but "forgets" to update the version of BookX, so it says that the update failed.
Anyway, I have uploaded a fixed version at the sourceforge site: https://sourceforge.net/projects/zencartbookx/files/

The only file that has changed is ADMIN/includes/init_includes/init_product_type_bookx.php so you can also just update that file in your shop and then it should run (at least it does here).

Can you please confirm that this works for you, so I can update it here on the Zen cart site as well. The submission process here is a bit longer, so I'd like to know that it works first...

Greetings,
p.

Hi Philou,
Thank you for the feedback; I'll try it and keep you advised of all the process.
I'll make the sandbox for you and for all for this ad-on ( for the benefit of all the zenner community ) untill we come up with a hard rock script ( cause I think there are few other things that I 'd like to see fixed - I'll talk to you about in my next post)
Thanks again
H.

I tried it and here's what I get ( same as previous try ): "WARNING: An Error occurred, please refresh the page and try again."
Another thing;
The product description shows in list but not in detail page.
It a little bit messy, philou.
If you don't find the bug, it could be caused by me, due to the integration of several other plugins.
I like your ad-on , it's pretty pro to show all details about a book; but I'am wondering about those few interferences with other plugins that could make the whole thing instable.
Thank you for all the efforts your putting in it.