Administrative Console Commands

allow_open_proxy

Marks an IP address as not being an open proxy for the next 24 hours.

Arguments:

• ip. The IP address to mark as clear.

• forever. Set to 'forever' if this proxy should be allowed forever.

ban_list

List banned users.

Arguments:

• user. Optional; list bans in a community you maintain, or any user if you have the 'finduser' priv.

ban_set

Ban another user from posting in your journal. In the future, banning a user will also prevent them from text messaging you, adding you as a friend, etc... Basically, banning somebody restricts their interaction with you severely.

Arguments:

• user. This is the user which the logged in user wants to ban.

• community. Optional, to ban a user from a community you run.

ban_unset

Remove a ban on a user.

Arguments:

• user. The user that will be unbanned by the logged in user.

• community. Optional, to unban a user from a community you run.

change_community_admin

Change the ownership of a community.

Arguments:

• community. The username of the community.

• new_owner. The username of the new owner of the community.

change_journal_status

Change the status of an account.

Arguments:

• account. The account to update.

• status. One of 'normal', 'memorial', 'locked'. Memorial accounts allow new comments to entries, locked accounts do not allow further comments. Entries are blocked either way.

change_journal_type

Change a journal's type.

Arguments:

• journal. The username of the journal that type is changing.

• type. Either 'person', 'shared', or 'community'.

• owner. If converting from a person to a community, specify the person to be made maintainer in owner. If going the other way from community/shared to a person, specify the account to adopt the email address and password of.

community

Add or remove a member from a community.

Arguments:

• community. The username of the community.

• action. Only remove is supported right now.

• user. The user you want to remove from the community.

deletetalk

Delete a comment.

Arguments:

• user. The username of the journal comment is in.

• itemid. The itemid of the post to have a comment deleted from it.

• talkid. The talkid of the comment to be deleted.

expunge_userpic

Expunge a user picture icon from the site.

Arguments:

• user. The username of the picture owner.

• picid. The id of the picture to expunge.

faqcat

Tool for managing FAQ categories.

Arguments:

• command. One of: list, delete, add, move. 'list' shows all the defined FAQ categories, including their catkey, name, and sortorder. Also, it shows all the distinct catkeys that are in use by FAQ. 'add' creates or modifies a FAQ category. 'delete' removes a FAQ category (but not the questions that are in it). 'move' moves a FAQ category up or down in the list.

• commandargs. 'add' takes 3 arguments: a catkey, a catname, and a sort order field. 'delete' takes one argument: the catkey value. 'move' takes two arguments: the catkey and either the word "up" or "down".

find_user_cluster

Finds the cluster that the given user's journal is on.

Arguments:

• user. The user to locate.

finduser

Find a user by a criteria.

Arguments:

• criteria. Currently the only known criterias are 'email', 'userid', or 'user'

• data. The thing you know about the user, either their username, userid, or their email address.

friend

List your friends, add a friend, or remove a friend. Optionally, add friends to friend groups.

Arguments:

• command. Either 'list' to list friend, 'add' to add a friend, or 'remove' to remove a friend.

• username. The username of the person to add or remove when using the add or remove command.

• group. When using command 'add', this optional parameter can list the name of a friend group to add the friend to. The group must already exist.

• fgcolor. When using command 'add', this optional parameter specifies the foreground color associated with this friend. The parameter must have the form "fgcolor=#num" where 'num' is a 6-digit hexadecimal number.

• bgcolor. When using command 'add', this optional parameter specifies the background color associated with this friend. The parameter must have the form "bgcolor=#num" where 'num' is a 6-digit hexadecimal number.

gencodes

Generate invite codes.

Arguments:

• username. User to be given the codes

• quantity. Number of codes to generate

get_maintainer

Finds out the current maintainer(s) of a community or the communities that a user maintains. If you pass a community as the argument, the maintainer(s) will be listed. Otherwise, if you pass a user account, the account(s) they maintain will be listed.

Arguments:

• community or user name. The username of the account you want to lookup.

getemail

Get a user's email address. (for emailing them about TOS violations)

Arguments:

• user. The username of the person whose email address you'd like to see.

help

Get help on admin console commands

Arguments:

• command. The command to get help on. If ommitted, prints a list of commands.

infohistory

Retrieve the infohistory of a given user

Arguments:

• user. The user whose infohistory is being retrieved.

moodtheme_create

Create a new mood icon set. Return value from this command is the moodthemeid that you'll need to define pictures for this theme.

Arguments:

• name. Name of this theme, to appear in various places on the site

• des. Some description of the theme

moodtheme_list

List mood themes, or data about a mood theme

Arguments:

• themeid. Optional mood theme ID. If given, you view the data for that theme, otherwise you see just a list of the available mood themes

moodtheme_public

Make a mood theme public or not. You have to be a moodthememanager to do this.

Arguments:

• themeid. Mood theme ID number.

• setting. Either 'Y' or 'N' to make it public or not public, respectively.

moodtheme_setpic

Change data for a mood theme. If picurl, width, or height is empty or zero, the data is deleted.

Arguments:

• themeid. Mood theme ID number.

• moodid. Mood ID number.

• picurl. URL to picture to show for this moodid in this themeid. If a public one, use /img/mood/themename/file.gif

• width. Width of picture

• height. Height of picture

print

This is a debugging function. Given an arbitrary number of meaningless arguments, it'll print each one back to you. If an argument begins with a bang (!) then it'll be printed to the error stream instead.

priv

Grant or revoke user privileges.

Arguments:

• action. 'grant', 'revoke', or 'revoke_all' to revoke all args for a given priv

• privs. Comma-delimited list of priv names or priv:arg pairs

• usernames. Comma-delimited list of usernames

reset_email

Resets the email address for a given account

Arguments:

• username. The account to reset the email address for.

• value. Email address to set the account to.

• reason. Reason for the reset

reset_password

Resets the password for a given account

Arguments:

• username. The account to reset the email address for.

• reason. Reason for the password reset.

set

Set a userprop.

Arguments:

• community. Community to set property for, if you're a maintainer.

• propname. Property name to set.

• value. Value to set property to.

shared

Add or remove access for a user to post in a shared journal.

Arguments:

• sharedjournal. The username of the shared journal.

• action. Either add or remove.

• user. The user you want to add or remove from posting in the shared journal.

suspend

Suspend a user's account.

Arguments:

• user. The username of the person to suspend.

• reason. Why you're suspending the account.

syn_editurl

Changes the syndication URL for a syndicated account.

Arguments:

• username. The username of the syndicated journal.

• newurl. The new URL to syndicate the journal from.

unsuspend

Unsuspend a user's account.

Arguments:

• user. The username of the person to unsuspend.

• reason. Why you're unsuspending the account.