Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
module:avatars [2019/06/04 02:11] – [Message Default Avatar] Fixed typo digital manmodule:avatars [2021/01/11 23:59] (current) – [Options] typo digital man
Line 14: Line 14:
 ===== Collections ===== ===== Collections =====
  
-The set of [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/text/avatars/|stock avatar collections]] available for users to choose from includes over 150 original pieces of ANSI-art created and contributed by Synchronet sysops: [[person:digital man]], [[person:echicken]], and [[person:kirkman]].+The set of [[https://gitlab.synchro.net/sbbs/sbbs/-/tree/master/text/avatars/|stock avatar collections]] available for users to choose from includes over 150 original pieces of ANSI-art created and contributed by Synchronet sysops: [[person:digital man]], [[person:echicken]], and [[person:kirkman]].
  
 The following screen shots are some of the stock avatar collections being shown in the ANSI terminal mode //Avatar Chooser// (a web-based avatar chooser is also [[https://bbs.electronicchicken.com/?page=More/avatar-gallery.xjs|in the works]], per [[person:echicken]]): The following screen shots are some of the stock avatar collections being shown in the ANSI terminal mode //Avatar Chooser// (a web-based avatar chooser is also [[https://bbs.electronicchicken.com/?page=More/avatar-gallery.xjs|in the works]], per [[person:echicken]]):
Line 53: Line 53:
 | ''[[dir:exec]]/logon.js''              | Updated to display user's avatar during logon sequence | | ''[[dir:exec]]/logon.js''              | Updated to display user's avatar during logon sequence |
 | ''[[dir:exec]]/newuser.js''            | Updated to set a new user's default avatar, when configured in ''modopts.ini'' | | ''[[dir:exec]]/newuser.js''            | Updated to set a new user's default avatar, when configured in ''modopts.ini'' |
-| ''[[dir:text]]/avatars/*.bin''         | Avatar collections (from CVS and imported from SYNCDATA) |+| ''[[dir:text]]/avatars/*.bin''         | Avatar collections (from the Synchronet Source Repository and imported from SYNCDATA) |
  
  
Line 61: Line 61:
 If running Synchronet v3.16 or a non-current v3.17: If running Synchronet v3.16 or a non-current v3.17:
  
-Download the file ''[[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/text/menu/msghdr.asc|msghdr.asc]]'' to your ''[[dir:text]]/menu/'' directory, if you do not already have it (e.g. from CVS).+Download the file ''[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/text/menu/msghdr.asc|msghdr.asc]]'' to your ''[[dir:text]]/menu/'' directory, if you do not already have it (e.g. from [[dev:Git]]).
  
 This ''msghdr.asc'' will execute the script ''[[dir:exec]]/showmsghdr.js'' whenever a message header is displayed to a user of the Terminal Server. This ''msghdr.asc'' will execute the script ''[[dir:exec]]/showmsghdr.js'' whenever a message header is displayed to a user of the Terminal Server.
Line 74: Line 74:
  
 ==== Step 1 ====  ==== Step 1 ==== 
-If you haven't already, get the ''[[dir:text]]/avatars'' directory contents either via CVS or [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/text/avatars/?view=tar|download]] from this web-page: http://cvs.synchro.net/cgi-bin/viewcvs.cgi/text/avatars/+If you haven't already, get the ''[[dir:text]]/avatars'' directory contents either via Git or download from this web-page: https://gitlab.synchro.net/sbbs/sbbs/-/tree/master/text/avatars/
  
 ... and place these files in your Synchronet ''text/avatars'' directory (create it if it doesn't exist). ... and place these files in your Synchronet ''text/avatars'' directory (create it if it doesn't exist).
Line 193: Line 193:
 Other than command-line parameters, the only configuration options for ''avatars.js'' are stored in the ''[avatars]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file: Other than command-line parameters, the only configuration options for ''avatars.js'' are stored in the ''[avatars]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file:
  
-<file modopts.ini>+<file ini>
 [avatars] [avatars]
 sub          = dove-syncdata sub          = dove-syncdata
Line 201: Line 201:
 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//) | +| sub          | //auto// | Sub-board internal code for import and export command (your networked //sync-data// message area) | 
-| export_freq  | Maximum export (to message-base) frequency, in days (default: ''7'') | +| export_freq  | ''7''    | Maximum export (to message-base) frequency, in days | 
-| msg_default  | Default avatar (base64-encoded) for displaying messages from users without an avatar | +| msg_default  | //none// | Default avatar (base64-encoded) for displaying messages from users without an avatar | 
-| //<sub-code>//_default | Default avatar (base64-encoded)for the specified message sub-board | +| //<sub-code>//_default   |//none//| Default avatar (base64-encoded) for the specified message sub-board (internal code, lowercase) | 
-| //<group-name>//_default | Default avatar (base64-encoded) for the specified message group |+| //<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 | 
  
 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).
Line 212: Line 216:
 Also in the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file: Also in the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file:
  
-<file modopts.ini>+<file ini>
 [newuser] [newuser]
 avatar = <base64-encoded avatar data> avatar = <base64-encoded avatar data>
Line 228: Line 232:
 The new user default avatar, if you have one, will be set with the ''avatar'' value in the ''[newuser]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file: The new user default avatar, if you have one, will be set with the ''avatar'' value in the ''[newuser]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file:
  
-<file>+<file ini>
 [newuser] [newuser]
 avatar=IH8gfyB/3H/cf9x/3H8gfyB/IH8gfyB/3n/bf9t/23/bf91/IH8gfyB/IH/ef9t/23/bf9t/3X8gfyB/IH8gf9x/23/bf9t/23/cfyB/IH8gf9t/23/bf9t/23/bf9t/238gfyB/23/bf9t/23/bf9t/23/bfyB/ avatar=IH8gfyB/3H/cf9x/3H8gfyB/IH8gfyB/3n/bf9t/23/bf91/IH8gfyB/IH/ef9t/23/bf9t/3X8gfyB/IH8gf9x/23/bf9t/23/cfyB/IH8gf9t/23/bf9t/23/bf9t/238gfyB/23/bf9t/23/bf9t/23/bfyB/
Line 355: Line 359:
 | disable            | Disable current user's avatar | | disable            | Disable current user's avatar |
 | disable=<usernum>  | Disable specified user's avatar | | disable=<usernum>  | Disable specified user's avatar |
-| newuser <filename> | Import a new user default avatar from specified avatar collection file |+| newuser <filename> | Import a new user default avatar from specified avatar collection file (use with ''-offset'') | 
 +| msg-default <filename> | Import a default message avatar from specified avatar collection file (use with ''-offset'') |
 | normalize <filenames> | Normalize one or more avatars | | normalize <filenames> | Normalize one or more avatars |
 | normalize             | Normalize the current user's avatar | | normalize             | Normalize the current user's avatar |
Line 366: Line 371:
 | -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 |

Trace: