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
Next revisionBoth sides next revision
module:avatars [2019/06/04 02:03] – [modopts.ini] Document msg_default and other new keys digital manmodule:avatars [2019/07/17 00:28] – Use syntax highlighting digital man
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 205: Line 205:
 | export_freq  | Maximum export (to message-base) frequency, in days (default: ''7'') | | export_freq  | Maximum export (to message-base) frequency, in days (default: ''7'') |
 | msg_default  | Default avatar (base64-encoded) for displaying messages from users without an avatar | | msg_default  | 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 | 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 | Default avatar (base64-encoded) for the specified message group (name, lowercase)|
  
 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 212:
 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 228:
 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 234: Line 234:
  
 This value can be set/changed with the ''avatar.js'' ''newuser'' command. For example, using [[util:JSexec]]: This value can be set/changed with the ''avatar.js'' ''newuser'' command. For example, using [[util:JSexec]]:
-  jsexec avatars newuser=/sbbs/text/avatars/silhouettes.bin+  jsexec avatars newuser=/sbbs/text/avatars/silhouettes.bin -offset=0 
 +   
 +**Note:**\\ 
 +If no ''-offset'' value is provided, then an avatar will be chosen from the specified avatar collection (''.bin'' file) at random.
      
  
Line 241: Line 244:
 If the ''avatar_offset'' key is not set (e.g. to a 0-based record index into the ''.bin'' file), then an avatar will be chosen at random from the specified ''avatar_file''. If the ''avatar_offset'' key is not set (e.g. to a 0-based record index into the ''.bin'' file), then an avatar will be chosen at random from the specified ''avatar_file''.
  
 +==== Message Default Avatar ====
 +
 +A default message avatar may be imported into the ''msg_default'' key of the ''[avatars]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file using [[util:JSexec]]:
 +  jsexec avatars msg-default=/sbbs/text/avatars/silhouettes.bin -offset=0
 +  
 +**Note:**\\
 +If no ''-offset'' value is provided, then an avatar will be chosen from the specified avatar collection (''.bin'' file) at random.
 +
 +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.
 +  
 ===== Specifications ===== ===== Specifications =====
  
Line 342: Line 355:
 | 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 |

Trace: