[GUI Plugin] FanFicFare

[ownedbycats]

JimmXinu - Is there way to add "Set Collection URL" like Author and Series?

[JimmXinu]

Originally Posted by DevilsReject97

How would it work when in use? Would it just download whatever up to the point of failure or does it need to complete so many chapters?

This looks like you don't have continue_on_chapter_error:true set. It should appear in the log when it triggers.

[JimmXinu]

Originally Posted by ownedbycats

JimmXinu - Is there way to add "Set Collection URL" like Author and Series?

I don't understand the question. What's "Set Collection URL" in this context?

The only thing that comes to mind is the FFF Standard Columns tab where Author and Series URLs can be set in Calibre's standard tables. And there isn't an equivalent 'Collection'.

[JimmXinu]

Originally Posted by estherflails

Hello. I see you added collectionsUrl and collectionsHTML to base_otw in the last update. I tried to add them to extra_valid_entries and download them to a custom column or the title page, but it didn't work. Any idea what I must be doing wrong?

Without seeing your settings, all I can do is guess...

defaults.ini already adds them to extra_valid_entries--you shouldn't need to do so again.

Are your custom_columns_settings and titlepage_entries (or add_to_titlepage_entries) in the correct [sections]?

Did you remember the leading ',' for add_to_titlepage_entries and leading spaces for custom_columns_settings?

[DevilsReject97]

Originally Posted by JimmXinu

This looks like you don't have continue_on_chapter_error:true set. It should appear in the log when it triggers.

#continue_on_chapter_error:true

Should that be at the bottom of the .ini field? I can add that there to override like it says, which would be ideal for me to be honest.

[JimmXinu]

Originally Posted by DevilsReject97

#continue_on_chapter_error:true

Should that be at the bottom of the .ini field? I can add that there to override like it says, which would be ideal for me to be honest.

Remove the '#' comment marker.

[ownedbycats]

Originally Posted by JimmXinu

I don't understand the question. What's "Set Collection URL" in this context?

The only thing that comes to mind is the FFF Standard Columns tab where Author and Series URLs can be set in Calibre's standard tables. And there isn't an equivalent 'Collection'.

If you have a custom column set for collection, I mean.

[JimmXinu]

Originally Posted by ownedbycats

If you have a custom column set for collection, I mean.

Maybe?

It would have to be generalized for make_linkhtml_entries. And an additional setting in custom_columns_settings for whether it should be done or not?

Plus Calibre tends to only allow one entry in each table per value, so if you have the same 'string' from different sites or authors I suspect they will conflict and overwrite each other like Authors do.

What's the use case? Would it be useful or just completionist? Can you use collectionsHTML instead?

[estherflails]

Originally Posted by JimmXinu

Without seeing your settings, all I can do is guess...

defaults.ini already adds them to extra_valid_entries--you shouldn't need to do so again.

Are your custom_columns_settings and titlepage_entries (or add_to_titlepage_entries) in the correct [sections]?

Did you remember the leading ',' for add_to_titlepage_entries and leading spaces for custom_columns_settings?

I'm quite sure I did it right but I can't get it to work. I'll attach the personal.ini this time, hopefully you can figure it out. :)

Spoiler:

## An 'Update Always' that doesn't add a new last chapter will also remove the end notes.
## DO NOT USE UPDATE ALWAYS.


## This is an example of what your personal configuration might look
## like.  Uncomment options by removing the '#' in front of them.

[defaults]
## [defaults] section applies to all formats and sites but may be
## overridden at several levels.  Example:

## [defaults]
## titlepage_entries: category,genre, status
## [www.whofic.com]
## # overrides defaults.
## titlepage_entries: category,genre, status,dateUpdated,rating
## [epub]
## # overrides defaults & site section
## titlepage_entries: category,genre, status,datePublished,dateUpdated,dateCreated
## [www.whofic.com:epub]
## # overrides defaults, site section & format section
## titlepage_entries: category,genre, status,datePublished
## [overrides]
## # overrides all other sections
## titlepage_entries: category

## Some sites also require the user to confirm they are adult for
## adult content.  Uncomment by removing '#' in front of is_adult.
is_adult:true

## Don't like the numbers at the start of chapter titles on some
## sites?  You can use strip_chapter_numbers to strip them off.  Just
## want to make them all look the same?  Strip them off, then add them
## back on with add_chapter_numbers.  Don't like the way it strips
## numbers or adds them back?  See chapter_title_strip_pattern and
## chapter_title_add_pattern.
#strip_chapter_numbers:true
#add_chapter_numbers:true

## Add this to genre if there's more than one category.
#add_genre_when_multi_category: Crossover


## Adds the tag "oneshot" to 1-chapter completed stories. Copy-pasted from FAQ.
# defaults so is affects everything, but can be overridden by 
# more specific sections.
#[defaults]
# 'add_to_' concats on to existing param, thus the leading comma
add_to_extra_valid_entries:,oneshot
# oneshot is a copy of status because status itself isn't a list.
include_in_oneshot:status
# add oneshot to the tags that are included in epub & calibre.
add_to_include_subject_tags:,oneshot

# Change oneshot to ['Completed'] to ['Completed','Oneshot'] only when
# numChapters is exactly 1.
# with ',' instead of '\,' it would be ['Completed'] to 
# ['Completed,Oneshot']--one string instead of two.
#add_to_replace_metadata:

## oneshot thing over.

### http://www.mobileread.mobi/forums/sh...59221&page=443
###custom_columns_settings: oneshot=>#fanficstatus
###replace_metadata:
## Sets one-chapter fics to oneshot oneshot=>Completed=>Oneshot&&numChapters=>^1$
# 'add_to_' concats on to existing param, thus the leading comma
###add_to_extra_valid_entries:,oneshot,tagscategory,
# oneshot is a copy of status because status itself isn't a list.
###include_in_oneshot:status

add_to_replace_metadata:
 oneshot=>Completed=>Completed\,Oneshot&&numChapters=>^1$

replace_metadata:
 series=>(.*)=>

[epub]
## include images from img tags in the body and summary of stories.
## Images will be converted to jpg for size if possible.  Images work
## in epub format only.  To get mobi or other format with images,
## download as epub and use Calibre to convert.
#include_images:true

## If not set, the summary will have all html stripped for safety.
## Both this and include_images must be true to get images in the
## summary.
#keep_summary_html:true

## If set, the first image found will be made the cover image.  If
## keep_summary_html is true, any images in summary will be before any
## in chapters.
make_firstimage_cover:false

## Resize images down to width, height, preserving aspect ratio.
## Nook size, with margin.
#image_max_size: 580, 725
image_max_size: 1180,980

## Change image to grayscale, if graphics library allows, to save
## space.
#grayscale_images: false


## Most common, I expect will be using this to save username/passwords
## for different sites.  Here are a few examples.  See defaults.ini
## for the full list.

#titlepage_use_table: true
#titlepage_wide_entry:<b>${label}:</b> ${value}<br />
#wide_titlepage_entries:description
#titlepage_no_title_entry:${value}<br />

[archiveofourown.org]
use_workskin:true
# as of 2023.07.20
use_archiveofourown_gay:true
# as of 2025.05.22

## Some adapters collect additional meta information beyond the
## standard ones.  They need to be defined in extra_valid_entries to
## tell the rest of the FanFicFare system about them.  They can be
## used in include_subject_tags, titlepage_entries,
## extra_titlepage_entries, logpage_entries, extra_logpage_entries,
## and include_in_* config items.  You can also add additional entries
## here to build up composite metadata entries.
## archiveofourown.org, for example, fills genre (a standard
## entry) as the composite offreeformtags, ao3categories in
## include_in_genre.  If there's ever more than 4 series, add
## series04,series04Url etc.

extra_valid_entries:fandoms, freeformtags, freefromtags,
 ao3categories, comments, chapterslashtotal, chapterstotal, kudos,
 hits, bookmarks, collections, collectionsUrl, collectionsHTML, byline, bookmarked, bookmarktags,
 bookmarksummary, bookmarkprivate, bookmarkrec, restricted, series00,
 series01, series02, series03, series00Url, series01Url, series02Url,
 series03Url, series00HTML, series01HTML, series02HTML, series03HTML,
 series04, series05, series06, series07, series08, series09, series10,
 series04Url, series05Url, series06Url, series07Url, series08Url, series09Url, series10Url,
 series04HTML, series05HTML, series06HTML, series07HTML, series08HTML, series09HTML, series10HTML, series11HTML, series12HTML, series13HTML, series14HTML,
 empty, subscribed, associations, creatorstyle, markedforlater,
 inspired, inspiredUrl, inspiredHTML, endnotes, endnotesUrl, endnotesHTML, allseriesHTML

fandoms_label:Fandom
freeformtags_label:Additional Tags
freefromtags_label:Additional Tags
ao3categories_label:Category
## comments count
comments_label:Comments
chapterslashtotal_label:Chapters
chapterstotal_label:Total Chapters
kudos_label:Kudos
hits_label:Hits
collections_label:Collections
collectionsUrl_label:Collections
collectionsHTML_label:Collections
## Count of bookmarks on story by all users
bookmarks_label:Bookmarks
## Tags & Summary from *your* bookmark on the story.  Only collected
## if always_login:true
#bookmarked_label:I Bookmarked Story
#bookmarktags_label:My Bookmark Tags
#bookmarksummary_label:My Bookmark Summary
#bookmarkprivate_label:My Bookmark Private
#bookmarkrec_label:My Bookmark Rec
#markedforlater_label:I Marked for Later
#subscribed_label:I Subscribed
#restricted_label:Restricted to Registered Users
series00HTML_label:Series
series01HTML_label:Series
series02HTML_label:Series
series03HTML_label:Series
series04HTML_label:Series
series05HTML_label:Series
series06HTML_label:Series
series07HTML_label:Series
series08HTML_label:Series
series09HTML_label:Series
series10HTML_label:Series
series11HTML_label:Series
series12HTML_label:Series
series13HTML_label:Series
series14HTML_label:Series
empty_label:
#description_label:
#datecreated_label:Downloaded
warnings_label:Archive Warning

## (Plugin Only) - You can also populate calibre custom columns with
## the site specific metadata using custom_columns_settings (but only
## if 'Allow custom_columns_settings from personal.ini' is checked in
## the plugin GUI config.)  There are three parts, the entry name,
## then the label of the calibre custom column, then (optionally) a
## 'mode'.  'r' to Replace any existing values, 'a' to Add to existing
## value (use with tag-like columns), and 'n' for setting on New books
## only.  (Default is 'r'.)
add_to_custom_columns_settings:
 fandoms=>#fandoms,r
 freeformtags=>#freeformtags,r
 freefromtags=>#freeformtags,r
 ao3categories=>#ao3categories,r
 comments=>#reviews,r
 chapterslashtotal=>#chapterslashtotal,r
 chapterstotal=>#chapterstotal,r
 kudos=>#kudos,r
 hits=>#hits,r
 collections=>#collections,r
 bookmarks=>#bookmarks,r
 bookmarked=>#bookmarked,r
 bookmarktags=>#bookmarktags,r
 bookmarksummary=>#bookmarksummary,r
 bookmarkprivate=>#bookmarkprivate,r
 bookmarkrec=>#bookmarkrec,r
 restricted=>#restricted,r
 byline=>#byline,r
 series00Url=>#series00url,r
 series01Url=>#series01url,r
 series02Url=>#series02url,r
 series03Url=>#series03url,r
 series04Url=>#series04url,r
 series05Url=>#series05url,r
 series00=>#series00,r
 series01=>#series01,r
 series02=>#series02,r
 series03=>#series03,r
 series04=>#series04,r
 series05=>#series05,r
# series00HTML=>#series00html,r
# series01HTML=>#series00html,a
# series02HTML=>#series00html,a
# series03HTML=>#series00html,a
 subscribed=>#subscribed,r
 associations=>#associations,r
 inspired=>#inspired,r
 inspiredHTML=>#inspired,r

 markedforlater=>#markedforlater,r
 creatorstyle=>#creatorstyle,r
# added 2023.03.13

 allseriesHTML=>#serieshtml,r
 collectionsHTML=>#collectionshtml,r
# added 2025.10.04

include_in_allseriesHTML: series00HTML,series01HTML,series02HTML,series03HTML,series04HTML,series05HTML, series06HTML, series07HTML, series08HTML, series09HTML, series10HTML, series11HTML, series12HTML, series13HTML, series14HTML
# added 2023.12.07

keep_in_order_genre:true
keep_in_order_characters:true
keep_in_order_relationships:true
keep_in_order_category:true
keep_in_order_tags:true
keep_in_order_freeformtags:true
keep_in_order_freefromtags:true
keep_in_order_fandoms:true
keep_in_order_ships:true
keep_in_order_warnings:true
keep_in_order_bookmarktags:true
keep_in_order_collections:true
keep_in_order_allseries:true
keep_in_order_byline:true
keep_in_order_anthologyfff:true
keep_in_order_seriescomma:true
keep_in_order_seriesfff:true
keep_in_order_series:true
keep_in_order_pairing:true
keep_in_order_pairings:true
keep_in_order_inspired:true
keep_in_order_associations:true

#added on 2022.02.19
add_to_comma_entries:,reviews, comments, kudos, hits, bookmarks,


## Assume entryUrl, apply to "<a class='%slink' href='%s'>%s</a>" to
## make entryHTML.
make_linkhtml_entries:inspired,associations,endnotes,series00,series01,series02,series03,series04,series05,series06,series07,series08,series09,series10,series11,series12,series13,series14

#include_in_genre: freeformtags, ao3categories
#include_in_category:fandoms

## chapterslashtotal contains 1/3 or 1/1 or 3/? etc as reported by AO3.
## chapterstotal is just the total chapters part after the /
include_in_chapterstotal:chapterslashtotal.NOREPL

titlepage_entries: rating,warnings,ao3categories,empty.SHOW_EMPTY,fandoms,empty.SHOW_EMPTY,ships,empty.SHOW_EMPTY,characters,empty.SHOW_EMPTY,freeformtags,empty.SHOW_EMPTY,chapterslashtotal,numWords,datePublished,dateUpdated,bookmarks,comments,kudos,hits,collectionsHTML,collections,series00HTML,series01HTML,series02HTML,series03HTML,series04HTML,series05HTML, series06HTML, series07HTML, series08HTML, series09HTML, series10HTML, series11HTML, series12HTML, series13HTML, series14HTML,description,empty.SHOW_EMPTY,empty.SHOW_EMPTY


## adds to titlepage_entries instead of replacing it.
#extra_titlepage_entries: fandoms,freeformtags,ao3categories,comments,chapterslashtotal,chapterstotal,kudos,hits,bookmarks,bookmarked,bookmarktags,bookmarksummary,series00,series01,series02,series03,series00HTML,series01HTML,series02HTML,series03HTML,byline

#extra_subject_tags:fandoms,freeformtags,ao3categories
#exclude_notes:authorheadnotes,chaptersummary,chapterheadnotes,chapterfootnotes,authorfootnotes,inspiredlinks

## AO3 authorfootnotes and inspiredlinks end up in the 'last' chapter,
## but if updated, then there's a new 'last' chapter, leaving multiple
## copies.  This option applies the 'skip_on_ffdl_update' class to
## those tags which means they will be removed during epub reading for
## update.  This will only effect chapters added after turning the
## setting on.
## Result: Only the last chapter will have end notes.
## Side-effect: An 'Update Always' that doesn't add a new last
## chapter will also remove the end notes.
remove_authorfootnotes_on_update:true
## DO NOT USE UPDATE ALWAYS.

slow_down_sleep_time:10

## AO3 chapters have 'date' available for each chapter.
## These can be used with custom output (see
## https://github.com/JimmXinu/FanFicFa...i/CustomOutput ) or with
## chapter_title_*_pattern settings.
## Examples for html & epub:
[html]
include_tocpage: true
tocpage_entry:
 <a href="#section${index04}">${chapter}</a> ${date}<br />


[epub]
include_tocpage: true
tocpage_entry:
 <a href="file${index04}.xhtml">${chapter}</a> ${date}<br /><br />

## The 'date' value for chapters mentioned above can be formated with
## datechapter_format.  Otherwise it will default to
## datePublished_format
datechapter_format:%%Y-%%m-%%d

#include_logpage: smart
#include_logpage: true

## This section will override anything in the system defaults or other
## sections here.
[overrides]
## default varies by site.  Set true here to force all sites to
## collect series.
#collect_series: true

[JimmXinu]

Originally Posted by estherflails

I'm quite sure I did it right but I can't get it to work. I'll attach the personal.ini this time, hopefully you can figure it out.

You are overriding make_linkhtml_entries, so you aren't getting collections in it from defaults.ini:

...
## Assume entryUrl, apply to "<a class='%slink' href='%s'>%s</a>" to
## make entryHTML.
make_linkhtml_entries:inspired,associations,endnotes,series00,series01,series02,series03,series04,series05,series06,series07,series08,series09,series10,series11,series12,series13,series14
...

Instead do:

add_to_make_linkhtml_entries:,inspired,...

(And [code] tags preserve whitespace for better comprehension of INI. FYI.)

[ownedbycats]

Originally Posted by JimmXinu

Maybe?

It would have to be generalized for make_linkhtml_entries. And an additional setting in custom_columns_settings for whether it should be done or not?

Plus Calibre tends to only allow one entry in each table per value, so if you have the same 'string' from different sites or authors I suspect they will conflict and overwrite each other like Authors do.

What's the use case? Would it be useful or just completionist? Can you use collectionsHTML instead?

I think it's what estherflails was askingn about.

[estherflails]

Originally Posted by JimmXinu

You are overriding make_linkhtml_entries, so you aren't getting collections in it from defaults.ini:

...
## Assume entryUrl, apply to "<a class='%slink' href='%s'>%s</a>" to
## make entryHTML.
make_linkhtml_entries:inspired,associations,endnotes,series00,series01,series02,series03,series04,series05,series06,series07,series08,series09,series10,series11,series12,series13,series14
...

Instead do:

add_to_make_linkhtml_entries:,inspired,...

(And [code] tags preserve whitespace for better comprehension of INI. FYI.)

I made the change but unfortunately, I still can't get it to work. :( Any other ideas what might be causing this?