forked from christiespeich/Mooberry-Book-Manager
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
266 lines (167 loc) · 12 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
=== Mooberry Book Manager ===
Contributors: mooberrydreams
Donate link: http://www.mooberrydreams.com/
Tags: book, author, publisher, writer, books, writing, publishing, authors, library, book store, book management
Requires at least: 3.8.0
Tested up to: 4.4
Stable tag: 2.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
An easy-to-use system for authors. Add your new book to your site in minutes, including links for purchase or download, sidebar widgets, and more.
== Description ==
Mooberry Book Manager is an easy-to-use system for authors to add books to their Wordpress websites.
No coding is necessary to use Mooberry Book Manager. Adding books is as easy as filling out a form. Include as much or as little information as you want, including the book cover, links to purchase the book, reviews of the book, an excerpt, and more.
Mooberry Book Manager will create a page for each book, ensuring a consistent look on all of your pages.
Organize your book into grids with just a few clicks. Grids can include all of your books or a selection of books, and you choose how they are ordered. You can create multiple grids; for example, an "Available Now" page and a "Coming Soon" page. Grids update automatically when you edit or add books. Set it and forget it!
Feature books on your sidebar with four options:
* A random book
* The newest book
* A book that's coming soon
* A specific book
Mooberry Book Manager works with your chosen theme to provide a consistent look throughout your website.
Requires Wordpress 3.8 and Javascript.
Mooberry Book Manager can be translated into other languages! See `Other Notes` for more information.
**Getting Started with Mooberry Book Manager**
After installing and activating Mooberry Book Manager, you'll now have a Books menu. Use that to add your books to your website.
In order for your books to appear on your website, you need to add a Book Grid and/or a Widget.
To Add a Book Grid:
* Create a new Page or edit an existing one
* Scroll down to the Book Grid Settings section
* Choose the books, grouping, and sort order
* Save the page and view it. Click on any book cover to get details of the book
To Add a Widget:
* Go to Appearance -> Widget
* Drag the Mooberry Book Manager Book Widget to the Widget Area of your choice
* Choose the book to display
* Save the widget and view your website. Click on the book cover to get the details of the book.
Additonal questions?
Download the [User Manual](http://www.mooberrydreams.com/support/mooberry-book-manager-support/) (PDF format) (note: the manual is not updated for version 3 at this time)
**Coming Soon**
* Mooberry Book Manager Media Kit -- automagically create a media kit and get help writing press releases for your books
* Mooberry Book Manager Multi-Author -- support multiple authors, useful for small publishers or authors with more than one pen name
* Mooberry Book Manager Customizer -- customize the book pages and more
If you have suggestions for a new add-on, feel free to email me at bookmanager@mooberrydreams.com.
**Want regular updates?**
* Subscribe to Mooberry Dreams' mailing list: http://www.mooberrydreams.com/products/mooberry-book-manager/
* Like Mooberry Dreams on Facebook: https://www.facebook.com/MooberryDreams
== Installation ==
1. Upload the entire `mooberry-book-manager` directory to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
== Frequently Asked Questions ==
= Will Mooberry Book Manager work with my theme? =
Mooberry Book Manager has been designed to be theme-independent and should work for most themes. However, as there are infinite possibilities when developing themes and little required standardization, so some themes may not work as expected with the plugin. If Mooberry Book Manager isn’t working for your theme, [contact us](http://www.mooberrydreams.com/contact/) and we’ll see if we can help.
We have found issues when using Mooberry Book Manager with the Customizr theme. These issues should be resolved with v1.1.
Many theme incompatibilities should be solved with v3.0. If you continue to find problems with your theme, please [contact us](http://www.mooberrydreams.com/contact/).
= What’s the difference between Download Links and Retailer Links? =
Download Links should be used when you are allowing readers to download the book for free.
Retailer Links are used when you are linking to website for readers to purchase your book.
A single book most likely won’t have both Download Links and Retailer Links, unless your book is listed for free at retailers and you are also allowing readers to download the ebooks directly from your website.
= What link do I use for download links? How will my readers download the files? =
Your ebook files will need to be uploaded somewhere. You have a few options:
1. Upload to a public storage website such as Dropbox.
2. Upload directly to your website via FTP.
3. Upload to your website via Wordpress' Media Libary. **Note:** Wordpress does not allow you to upload .epub and .mobi files. You'll need to compress them into .zip files before uploading.
The link you enter on the book page should point directly to the file to download.
= Can I use affiliate links? =
Of course! Mooberry Book Manager doesn’t change your link, so you can set your Retailer Links to use your Amazon, Barnes and Noble, or other affiliate code.
= Why is there no Author field? =
Mooberry Book Manager is designed to be used by the author on the author's website. In this case, the author name would always be the same, and it's already written all over the website.
There are cases though when you might want to have an Author field. You might be an author who publishes under multiple pen names and has a single website. You might be a small publisher who works with multiple authors. Or you might not be an author at all, and using Mooberry Book Manager for a different purpose, such as for a book club. In those cases you have two options:
1. To simply display the author name, you could use another field, such as Subtitle, to display that information.
2. For more advanced handling of author names, use the Mooberry Book Manager Multi-Author plugin (coming soon). This will allow you to have a bio and photo of each author as well as advanced filtering and sorting on Book Grids based on author.
= Additional questions? =
Download the [User Manual](http://www.mooberrydreams.com/support/mooberry-book-manager-support/) (PDF format) (note: the manual is not updated for version 3 at this time)
== Screenshots ==
1. Adding your books to your website is as easy as filling out a form.
2. Mooberry Book Manager creates pages for all of your books, ensuring a consistent design.
3. Manage the books on your website the same way you manage your blog posts and pages.
4. Create custom grids of all your books with just a few clicks. They update automatically when you add a new book.
5. Choose from four types of widgets to feature books on your sidebar.
== Changelog ==
= 3.0 =
* Added: Book Grids can now be filtered and grouped by Editors, Illustrators, Cover Artists, and Publishers
* Added: Book Grids can now be grouped by several levels
* Added: Additional pretty links, ie /book/tag/{some-tag} which lists all matching books but display the full book page not a grid
* Added: Ability to update/change "Add to Goodreads" and "Coming Soon" book cover images (on settings page)
* Added: Custom text above and below auto-generated Book Grids (Wordpress 4.4+ only)
* Added: Tip Jar
* Added: Greek Translation
* Improved: Book Cover metabox moved above taxonomies, book info, and buy/download links metaboxes for greater visibility
* Improved: Book Pages and auto-generated Book Grids now created using a shortcode, which should allow them to play nicely with more themes
* Improved: Most book data is now stored in a custom table, allowing for faster and more complex grids
* Improved: Slugs for auto-generated Book Grids can now be customized in settings
* Improved: Settings Page moved to main Admin menu for greater visibility and tabs are now sub-pages of the Settings menu
* Improved: New Page Settings sub-page to better categorize settings
* Improved: 2nd set of retailer/download links only displays if excerpt is more than 1500 characters AND excerpt is expanded
* Improved: User interface and instructions/descriptions of fields updated/added
* Improved: "Published on" date now uses the format set in Wordpress General settings
* Improved: Browser tab title is now the title of grid when viewing an auto-generated grid
* Improved: Accessibility improved by all images now using ALT tags set by user OR a default ALT tag in case the user has not set one.
* Improved: Reordered metaboxes on Book Edit page
* Improved: Added filter to move Yoast SEO metabox lower on the Edit Book page
* Improved: Formats & Editions box defaults to closed on Book Edit page. Entering all this info looks intimidating and probably 95% of authors don't want/need this info on the website anyway.
* Improved: Added move up/down buttons on repeated fields on Edit Book page (reviews, retailer links, download links, and editions)
= 2.4.2 =
* Fixed: Switched from site_url to home_url to create series grid link on book page (caused a problem when Wordpress is installed in a different directory than web URL)
* Improved: Reduced size of included images. Hopefully will help 500 errors on activation.
= 2.4.1 =
* Fixed: Error about non-object sometimes happening (grid styles)
= 2.4 =
* Added: South African Rand (ZAR/R) to currency dropdown options
* Added: Ability to update the user who created the book (may need to enable "author" in the Screen Options)
* Updated: Compliant with Wordpress 4.4 update
= 2.3 =
* New: Added Russian translation
* New: Added Italian translation
* New: Buy Links on the bottom of the book page are now hidden if the excerpt is collapsed
* New: Added Editors, Illustrators, and Cover Artists
* Fixed: Remove roles when uninstalled
= 2.2 =
* New: Added Spanish translation
* Fixed: Compliant with Wordpress 4.3 (and works for < Wordpress 4.3)
* Fixed: Retailer images missing since version 2.0 restored
* Fixed: Improved translation string for Series and Genre grids for more flexibility
= 2.1 =
* New: Book Grids are now responsive
* New: Added Serbo–Croatian translation
* New: Choose which theme template to use for your book pages
* Improved: Filter Book Grids by tag
* Improved: Group Book Grids by tag
* Changed: Book Grids cover height configurable, instead of number of book per row
= 2.0.1 =
* Fixed: Flushes rewrite rules
= 2.0 =
* New: Added General Settings, Publisher Settings, and Edition Formats Settings
* New: Added Editions to book pages
* New: Added Librarian and Master Librarian Roles
* New: Added French translation
* Improved: Redesigned layout of Book Page
* Improved: Blank data defaults and labels no longer display on Book Page
* Improved: Added Comments support to books
* Fixed: Moved tags to new custom taxonomy instead of using post tags.
For revision history of older versions, please see changelog.md
== Upgrade Notice ==
= 2.2 =
Updated for Wordpress 4.3!
= 2.1 =
Responsive Book Grids and more!
= 2.0 =
Redesigned, responsive book page and much more!
== Other Notes ==
= Translations =
* English
* German
* French
* Serbo-Croatian
* Spanish
* Russian
* Italian
* Greek
**NOTE:** Mooberry Book Manager is translatable. If you'd like to volunteer a translation for your language, the template file (.pot) is available in the `languages` folder. [Contact us](http://www.mooberrydreams.com/contact/) when your translation is ready or if you need assistance.
* Thanks to [Kathrin Hamann](https://profiles.wordpress.org/thrakonia) for providing the German translation!
* Thanks to Yves for providing the French translation!
* Thanks to [Web Hosting Geeks](http://www.webhostinggeeks.com/) for the Serbo-Croatian translation!
* Thanks to Ana Gomez for the Spanish translation!
* Thanks to Sergey Kryukov for the Russian translation!
* Thanks to Fabrizio Guidicini for the Italian translation!
* Thanks to Eleni Linaki for the Greek translation!