| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| module:avatars [2020/08/23 15:27] – Change (most) links from viewcvs/cvsweb to gitlab. digital man | module:avatars [2026/03/01 23:45] (current) – [modopts.ini] Document the enabled option (defaults to true) digital man |
|---|
| | ''[[dir:exec]]/load/graphic.js'' | ANSI "graphics" library | | | ''[[dir:exec]]/load/graphic.js'' | ANSI "graphics" library | |
| | ''[[dir:exec]]/load/ansiterm_lib.js'' | ANSI terminal library | | | ''[[dir:exec]]/load/ansiterm_lib.js'' | ANSI terminal library | |
| | | ''[[dir:exec]]/load/identicon.js'' | Identicon library | |
| | ''[[dir:exec]]/showmsghdr.js'' | Module to display a message header, with avatar (i.e. executed via ''msghdr.asc'' for v3.16 ) | | | ''[[dir:exec]]/showmsghdr.js'' | Module to display a message header, with avatar (i.e. executed via ''msghdr.asc'' for v3.16 ) | |
| | ''[[dir:exec]]/showmsgavatar.js'' | Module to display a message avatar, only (using ''text.dat'' approach or custom ''msghdr.asc'') | | | ''[[dir:exec]]/showmsgavatar.js'' | Module to display a message avatar, only (using ''text.dat'' approach or custom ''msghdr.asc'') | |
| The ''showmsgavatar.js'' module uses the ''sub_default'' or ''//<group-name>//_default'' or ''//<sub-code>//_default'' values for a default avatar to show for messages from users without an avatar. | The ''showmsgavatar.js'' module uses the ''sub_default'' or ''//<group-name>//_default'' or ''//<sub-code>//_default'' values for a default avatar to show for messages from users without an avatar. |
| |
| ^ Option ^ Description ^ | ^ Option ^ Default ^ Description ^ |
| | sub | Sub-board internal code for import and export command (default: //auto-detected//) | | | enabled | ''true'' | Set to ''false'' to disable avatar prompting and display from the various avatar-enabled JS modules | |
| | export_freq | Maximum export (to message-base) frequency, in days (default: ''7'') | | | sub | //auto// | Sub-board internal code for import and export command (your networked //sync-data// message area) | |
| | msg_default | Default avatar (base64-encoded) for displaying messages from users without an avatar | | | export_freq | ''7'' | Maximum export (to message-base) frequency, in days | |
| | //<sub-code>//_default | Default avatar (base64-encoded) for the specified message sub-board (internal code, lowercase) | | | msg_default | //none// | Default avatar (base64-encoded) for displaying messages from users without an avatar | |
| | //<group-name>//_default | Default avatar (base64-encoded) for the specified message group (name, lowercase)| | | //<sub-code>//_default |//none//| Default avatar (base64-encoded) for the specified message sub-board (internal code, lowercase) | |
| | | //<group-name>//_default |//none//| Default avatar (base64-encoded) for the specified message group (name, lowercase)| |
| | | msghdr_draw_top | ''true'' | Display message avatar at the top-of-screen when the message header was displayed at top-of-screen | |
| | | msghdr_draw_above | ''true'' | Display message header avatar above current cursor position | |
| | | msghdr_draw_right | ''true'' | Display message header avatar right-justified | |
| | | auto_identicon | ''true'' | Auto-generate [[wp>identicons]] for users or message-authors/file-uploaders that don't have an avatar set | |
| |
| When user avatars or shared avatar collections (''.bin'' files) are updated, they will be exported immediately (or when the ''AVAT-OUT'' event is executed). | When user avatars or shared avatar collections (''.bin'' files) are updated, they will be exported immediately (or when the ''AVAT-OUT'' event is executed). |
| avatar_file = <filename of avatar collection> | avatar_file = <filename of avatar collection> |
| avatar_offset = <0-based record number of avatar to use> | avatar_offset = <0-based record number of avatar to use> |
| | avatar_identicon = <set to true to auto-generate an identicon based on new user's alias for their default avatar> |
| |
| [logon] | [logon] |
| Once imported into the ''modopts.ini'' file, you can rename or copy the ''msg_default'' key to ''//<sub-code>//_default'' or ''//<group-name>//_default'' as desired. The ''//<sub-code>//'' and ''//<group-name>//'' must be lower-case. | Once imported into the ''modopts.ini'' file, you can rename or copy the ''msg_default'' key to ''//<sub-code>//_default'' or ''//<group-name>//_default'' as desired. The ''//<sub-code>//'' and ''//<group-name>//'' must be lower-case. |
| | |
| | ===== Disable ===== |
| | |
| | While the Avatar system can be disabled by deleting the events and changing ''set_avatar'' to ''false'' in the ''[login]'' section of ''modopts.ini'', the events will be re-added and ''set_avatar'' set back to ''true'' the next time you run the ''update.js'' script. To prevent this, you must delete all the ''text/avatars/*.bin'' files, which will cause the ''install'' option of ''avatar.js'' to fail. |
| | |
| ===== Specifications ===== | ===== Specifications ===== |
| |
| | -v | Increase verbosity of console output (e.g. for trouble-shooting) | | | -v | Increase verbosity of console output (e.g. for trouble-shooting) | |
| | -offset=<value> | Specify a record offset of an avatar in an avatar collection file | | | -offset=<value> | Specify a record offset of an avatar in an avatar collection file | |
| | -realnames | When exporting user avatar, include the user's real name as well as their alias - required if the message network uses/requires real names | | | -realnames | When exporting user avatars, include the user's full real name as well as their alias | |
| | | -aliasonly | When exporting user avatars, do not include even an MD5-digest of the user's real name | |
| | -ptr=<value> | Over-ride the stored import/export message pointer value | | | -ptr=<value> | Over-ride the stored import/export message pointer value | |
| | -all | Import/export all messages (even those exported locally) - not normally recommended | | | -all | Import/export all messages (even those exported locally) - not normally recommended | |
