Mylist export SDK changelog

Changelog for MyList export SDK

 0.13.4 - 26.01.2009
   - data files updated

 0.13.3 - 10.10.2008 (linked with AniDB release 0.1.53)
   - data files updated
   - files that have episode relations now show up in the related episode listing
   - file->ep relations for a given episode are now handled in loop_ep and are called loop_data_ep_fileeprel

 0.13.2 - 28.07.2008
   - data files updated
   - updated jsencodexml
   - additions in loop_anime_genren:
       data_anime_genren_weight : Weight of the category
       data_anime_genren_weight_name : Textual notation of the category weight

 0.13.1 - 18.02.2008
   - data files updated (global_genren_loop is not on the dump)
   - added a new function: jsencodexml (check export_funcs.pm)
   - Removed the picurl for awards as they aren't present on the AniDB and are styled with css instead.

 0.13 - 09.09.2007
   - data files updated (global_genren_loop is not on the dump)
   - fixes
   ANIME:
       loop_anime_groups:
           data_anime_group_state - Now correctly outputs state
   - new fields
   GLOBAL:
        global_genren_loop: - New global loop for the cat system
            global_genren_id - cat id
            global_genren_name - cat name
            global_genren_parentid - cat parent id
            global_genren_ishentai - is cat 18+ restricted
        NOTES: you should try to limit the usage of this loop to mylist.tpl
   ANIME:
        loop_anime_groups:
            data_anime_group_eprange - episode range for a given group (as in AniDB)
            data_anime_group_alangs_loop: - loops group audio languags
                data_anime_group_alang_id - audio language id (i.e.: 1)
                data_anime_group_alang_name - audio language name (chinese,english, etc)
                data_anime_group_alang_sname - audio language short name (ja, ne, etc)
            data_anime_group_slangs_loop: - loops group sub languags
                data_anime_group_slang_id - sub language id (i.e.: 1)
                data_anime_group_slang_name - sub language name (chinese,english, etc)
                data_anime_group_slang_sname - sub language short name (ja, ne, etc)
        loop_anime_company:
            data_anime_company_type_name - company type string (company, organization, individual, etc)
            data_anime_company_atype_name - company relation to given anime string (production, music, etc)
   FILE:
        data_file_tth - tth hash (now actually added the hash, had forgot before)
        data_file_typename - file type string (video,audio,etc)
        data_file_ar_name - The AR string (4:3, 16:9, etc)
        data_file_chantype_name - channel string (Mono, Stereo, etc) (stream #1)
        data_file_chantype_name2 - channel string (Mono, Stereo, etc) (stream #2)
        data_file_atype - audio type id (stream #1)
        data_file_atype2 - audio type id (stream #2)
        data_file_atype_name - audio type string (stream #1)
        data_file_atype_name2 - audio type string (stream #2)
        data_file_stypename - subtitle type string (stream #1)
        data_file_stypename2 - subtitle type string (stream #2)

 0.12 - 04.07.2007
   - data files updated
   - new fields
   GLOBAL:
       global_user_id - AniDB user ID
   ANIME:
       status_anime_isrestricted - Anime has +18 restricted audience (0/1)
       data_anime_name_langname - Language name (ie: Japanese)
       data_anime_name_langsname - Language shortname (ie: ja)
       data_anime_eps_special - Total number of special episodes
       data_anime_eps_total - Total number of episodes
       loop_anime_groups: [new loop]
           data_anime_group_id - Group ID
           data_anime_group_agid - Group AGID
           data_anime_group_name - Group name
           data_anime_group_sname - Group shortname
           data_anime_group_state - Group state (complete, dropped, etc)
           data_anime_group_lastep - Last episode released
           data_anime_group_lastup - Last update date (dd.mm.yyyy hh:mm)
           data_anime_group_votes - Number of votes
           data_anime_group_rating - Rating
           data_anime_group_cmts - Number of comments
           data_anime_group_epcnt - Normal episode count
           data_anime_group_sepcnt - Specials count (S + O + C + T + P eps)
           data_anime_group_myvote - My vote or '-' if none
           data_anime_group_myvote_date - My vote date (dd.mm.yyyy hh:mm)
       loop_anime_titles: [new loop]
           data_anime_title_name - Title
           data_anime_title_langid - Language ID
           data_anime_title_type_id - Type ID (1 = main, 2 = syn, 3 = short, 4 = official)
           data_anime_title_type_string - Type name (main, syn, short, official)
           data_anime_title_langname - Language name (ie: Japanese)
           data_anime_title_langsname - Language shortname (ie: ja)
       loop_anime_title_alias: [existing loop]
           data_anime_title_alias_langname - Language name (ie: Japanese)
           data_anime_title_alias_langsname - Language shortname (ie: ja)
       loop_anime_title_short: [existing loop]
           data_anime_title_short_langname - Language name (ie: Japanese)
           data_anime_title_short_langsname - Language shortname (ie: ja)
       loop_anime_title_official: [existing loop]
           data_anime_title_official_langname - Language name (ie: Japanese)
           data_anime_title_official_langsname - Language shortname (ie: ja)
   EP:
       data_ep_myvote - My vote for a given episode
       data_ep_myvote_date - My vote date for a given episode
   FILE:
       data_file_tth - TTH hash
       loop_data_file_filerel: [new loop]
           data_file_filerel_fid - one end of the relation
           data_file_filerel_otherfid - the other end of the relation
           data_file_filerel_type - type of the relation (subtitle file, etc)
       loop_data_file_fileeprel: [new loop]
           data_file_fileeprel_fid - the fid that spans eps
           data_file_fileeprel_eid - the episode
           data_file_fileeprel_startp - start percentage
           data_file_fileeprel_endp - end percentage
       data_file_lang_sname - Language shortname (ie: ja)
       data_file_lang_sname2 - Language shortname (ie: ja)
       data_file_sub_sname - Language shortname (ie: ja)
       data_file_sub_sname2 - Language shortname (ie: ja)
   - fixed fields
       data_anime_mystate_string - wasn't outputting correctly for mixed state
   - better support for wishlisted anime with no files, anime information only will be exported

 0.11b - 27.06.2007
   - data files updated

 0.11 - 26.06.2007
   - data files updated
   - documentation moved to wiki
   - new fields
   ANIME:
       data_anime_my_vote_date
       data_anime_my_vote_date_short
       data_anime_my_tmpvote_date
       data_anime_my_tmpvote_date_short
   FILE:
       data_file_ldate
       data_file_ldate_short

 0.10b - 10.05.2006
   - updated documentation, examples and export code

 0.10 - 30.04.2006
   - fixed file data (only data for 1 video and 2 audio/subtitle streams available)
   - new fields
   FILE:
       data_file_type
       data_file_vidcnt
       data_file_ar
       data_file_fps
       data_file_vflags
       data_file_audcnt
       data_file_chantype
       data_file_abitrate2
       data_file_acodec_id2
       data_file_acodec_name2
       data_file_chantype2
       data_file_lang_id2
       data_file_lang_name2
       data_file_subcnt
       data_file_sflags
       data_file_stype
       data_file_sub_id2
       data_file_sub_name2
       data_file_sflags2
       data_file_stype2
       data_file_length
   ANIME:
       data_anime_annid
       status_anime_ann_listed
       data_anime_annurl
       data_anime_allcinemaid
       status_anime_allcinema_listed
       data_anime_allcinemaurl
       loop_anime_genren
       data_anime_genren_id
       data_anime_genren_name
       data_anime_genren_parentid
       data_anime_genren_ishentai
       loop_anime_tag
       data_anime_tag_id
       data_anime_tag_name
       data_anime_tag_date
       loop_anime_company
       data_anime_company_id
       data_anime_company_name
       data_anime_company_shortname
       data_anime_company_othername
       data_anime_company_type
       data_anime_company_url
       data_anime_company_picurl
       data_anime_company_aptype
   GLOBAL:
       global_userstat_animeadded
       global_userstat_epsadded
       global_userstat_filesadded
       global_userstat_groupsadded
       global_userstat_lamefiles
       global_userstat_lamefilesp
       global_userstat_independencep
       global_userstat_leechp
       global_userstat_reviews
       global_userstat_votes
       global_userstat_totalviewedp
       global_userstat_totalownedp
       global_userstat_ownviewedp
       global_userstat_viewedepcnt

 0.09b - 13.10.2005
   - fixed episode number issue
   - added more info on ep type ids to docs
   - removed file shared/released info from docs

 0.09 - 25.09.2004
   - added new, redundant file crc info flag
       status_file_state_crcunverified
   - fixed animeplanet links
       data_anime_animeplaneturl
   - added flag to show if a file comment is present
       status_file_hascomment
       (remember, the filecomment can be found in: data_file_other)
   - added flag to show if a file is a generic file (btw. that means size==0)
       status_file_isgeneric
   - added new MyList filestate info
       data_file_myfilestate (0=normal, 1=invalid crc, 2=self edited,
          10=self ripped, 11=on dvd, 12=on vhs, 13=on tv, 14=theater,
          100=other)
       data_file_myfilestate_string, data_file_myfilestate_icon
       status_file_myfilestate_normal, status_file_myfilestate_invalidcrc,
       status_file_myfilestate_selfedited, status_file_myfilestate_selfripped,
       status_file_myfilestate_ondvd, status_file_myfilestate_onvhs,
       status_file_myfilestate_ontv, status_file_myfilestate_theater,
       status_file_myfilestate_other
   - added air and end date for anime
       data_anime_startdate, data_anime_startdate_short
       data_anime_enddate, data_anime_enddate_short
   - added romaji and kanji episode titles
       data_ep_name_romaji, status_ep_hasname_romaji
       data_ep_name_kanji, status_ep_hasname_kanji
   - added wishlist info to anime
       status_anime_isinwishlist
       data_anime_wishlist_type (0="unknown / unfiled", 1="to watch", 2="to get", 3="blacklist"),
       data_anime_wishlist_type_name,
       data_anime_wishlist_priority (0="low", 1="medium", 3="high"),
       data_anime_wishlist_priority_name,
       data_anime_wishlist_comment
   - added vote/tmpvote info for anime
       status_anime_my_isvoted, data_anime_my_vote
       status_anime_my_istmpvoted, data_anime_my_tmpvote
   - added id.txt with a list of AniDB ids
   - new versions of some themes included
   - updated data dump
   - minor changes

 0.08 - 18.04.2004
   - added new tempvote info to anime data
       data_anime_tmprating, data_anime_tmpvotes
   - added ep vote data
       data_ep_rating, data_ep_votes
   - added file version string (v1, v2,...)
       data_file_state_versionname
   - added additional redundant anime award info which can be accessed without using the loops
       data_anime_awardicons, status_anime_hasawards
   - data files updated
   - IMPORTANT: new info.dat rules see templatehowto.txt

 0.07 - 11.04.2004
   - added info on new anime titles
       data_anime_title_jap_kanji, status_anime_title_has_jap_kanji
       data_anime_title_eng, status_anime_title_has_eng
       data_anime_title_other, status_anime_title_has_other
   - status_ep_state_hanger is now always 0
   - added data_file_sha1
   - added award info
       loop_anime_award_types
           data_anime_award_type_id
           data_anime_award_type_name
           data_anime_award_type_img
       loop_anime_awards
           data_anime_award_id
           data_anime_award_name
           data_anime_award_url
           data_anime_award_picurl
           data_anime_award_type

 0.06 - 06.09.2003
   - added animeplanet info:
       data_anime_animeplanetid (not really useful yet, 1 for all anime, this will change someday though)
       data_anime_animeplaneturl
       status_anime_animeplanet_listed
   - fixed bug in data_anime_my_unwatchedeps_special
   - fixed bug in data_ep_mystate_*

 0.05 - 26.08.2003
   - export.pl now copies any additional files found in a themes directory into the out directory
     you can use this to automatically include stylesheet or javascript files with your templates.
     however subdirectories are not copied and you should also not use this to include images.
     simply create a zip file contraining all images in the theme directory and i will upload it
     to the AniDB http server and link to it. (faq updated)
   - jsencode now also strips newlines
   - new parsing function jsencodehtml which replaces:
       ' => ’    " => "     \n => < br >
   - data_anime_my_eps now only lists normal eps, not specials. same goes for data_anime_watchedeps and data_anime_unwatchedeps
     additional data fields:
       data_anime_my_*_special   - number of special eps
       data_anime_my_*_total      - total number, same as old data_anime_my_*
   - data_anime_my_unwatchedeps, data_anime_my_unwatchedeps_special, data_anime_my_unwatchedeps_total where undocumented so far
   - status_anime_iscomplete and status_anime_iswatched haven been updated to match the current MyList style of only
     taking normal eps into account.
   - status_ep_mystate_* and status_anime_mystate_* added to reflect the latest MyList changes on AniDB
     this allows you now to include state icons on episode and anime level as AniDB does it.
   - plaintext dump of the small data file is now included, take a look at datadump.txt if you need info on
     undocumented vars or just want to know what data format to expect. if you encounter a problem or unexpected data in
     some vars it might also be a good idea to take a look at this file.

 0.04b - 13.08.2003
   - status_file_state_* was not working correctly, fixed now.

 0.04 - 12.08.2003
   - switch to HTML::Template::Expr to support more interaction between templates and perl code
     you have much more options in the templates.
     !!! YOU WILL NEED TO INSTALL ADDITIONAL MODULES TO GET THE NEW SDK TO WORK !!! (see below)
     there are now additional commands available, i.e.:
         <TMPL_VAR EXPR="data_file_size_plain/8"> would give you the filesize in kB (note the 'EXPR')
         there are also a lot a predefined functions which can be used as
         <TMPL_VAR EXPR="function('string param')"> or <TMPL_VAR EXPR="function(variable)">
         multiple parameters are ',' seperated. i.e. <TMPL_VAR EXPR="function(var1,var2,'string')">
         check the url below for predefined functions
         additional functions are:
         jsencode() - one parameter, replaced ' with \', " with \" and ´ with \´
         replace() - 3 parameters (find, replacewith, string), i.e. ('a','b','abc') -> bbc
         ireplace() - same as replace but case insensitive
         additional functions can be added on request. the code is included with the SDK so you could also play
         around with some of your own functions.
     for more details check: http://html-template.sourceforge.net/html_template_expr.html
   - added data_anime_animenfoid, data_anime_animenfoid2, data_anime_animenfourl, data_anime_animenfourl_name
     data_anime_animenfoid is the old animenfo id, data_anime_animenfoid2 is the additional new one,
     data_anime_animenfourl is a complete url (without <a href="">, just a plain url) to the animenfo page of this anime
     data_anime_animenfourl_name is the link name as displayed on AniDB (i.e. "ID: 64" or "ID: 1235,rvvvjg")
   - data_file_size_plain contains plain size without dots, this is needed if you want to construct your own ed2k links
   - data_file_acodec_id, data_file_acodec_name, data_file_vcodec_id and data_file_vcodec_name were undocumented

 0.03 - 10.08.2003
   - fixed typo, the module needed is called Storable
   - added additional big data file which can be used to check templates on big MyLists
     to use it rename tpl-alist.dat to i.e. tpl-alist.dat.small and rename tpl-alist.dat.big
     to tpl-alist.dat.

 0.02 - 02.08.2003
   - additional data values
   All:
    * all data values now also have a _short version which ommits the time.
      i.e. data_ep_update_short = 02.08.03
       Anime:
     * status_anime_genre_<genre> is set to 0 or 1 according to added genres
      i.e. status_anime_genre_action = 1, if the anime has genre action added
      note: genres are all lower case and spaces are replaced with _
    * status_anime_iscomplete and status_anime_iswatched slightly changed to
      match the new way of doing things @ MyList @ AniDB. (anime with epcount = 0
      are no longer considered complete or completly watched)
   Ep:
    * epno does now correctly handle specials (epno 1001 => S1)
    * data_ep_state carries AniDB internal state number
      + EP_SPECIAL=1, EP_RECAP=2, EP_OP=4, EP_END=8, EP_HANGER=16
        (hanger = cliffhanger)
    * status_ep_state_special, status_ep_state_recap,
      status_ep_state_op, status_ep_state_end, status_ep_state_hanger
        are set according to data_ep_state so you might want to use these
        instead of data_ep_state
   File:
    * data_file_released is now "-" if no release date was added
    * data_file_state carries AniDB internal state number
      + FILE_CRCOK=1, FILE_CRCERR=2, FILE_ISV2=4, FILE_ISV3=8,
        FILE_ISV4=16, FILE_ISV5=32
        values are added to generate the data_file_state field
    * status_file_state_crcok, status_file_state_crcfailed,
      status_file_state_isv2, status_file_state_isv3,
      status_file_state_isv4, status_file_state_isv5
        are set according to data_file_state so you might want to use these
        instead of data_file_state
    * data_file_mystate carries AniDB internal MyList file state number
      + unknown=0, on hdd=1, on cd=2, deleted=3, shared=4, release=5
    * data_file_mystate_string gives the string representation
    * data_file_mystate_icon gives the icon known from AniDB (direct inet link to image,
      img tag already included)
    * status_file_mystate_unknown, status_file_mystate_onhdd, status_file_mystate_oncd,
      status_file_mystate_deleted, status_file_mystate_shared, status_file_mystate_release
        are set according to data_file_mystate

 0.01 - 08.07.2003
   - first version