From IkonWiki

Contents 1 IkonForums Global Settings 1.1 Edit Email Templates 1.2 MIME Types 1.2.1 Add MIME 1.2.2 Edit MIME List 1.3 Emoticons 1.3.1 Define emoticon(s) 1.3.2 Add emoticon(s) 1.3.3 Edit emoticon(s) 1.4 Quick Reply Emoticons 1.5 Help Manager 1.5.1 Edit Help Topics 1.5.1.1 Language Selection 1.5.1.2 Edit Language Help

IkonForums Global Settings

Edit Email Templates

Email Template Control
This IkonForums^© Email Management Utility allows the Board Administrator to view and edit any or all of the emails sent from your IkonForums Board.

Configuration

• None
  This is a simple text editor built into the IkonForums^© Control Panel.

What is an email template?
A simple text (non-HTML) generic email that utilizes IkonForums^© Email Content Tags to create personalized email content from your IkonForums Board to it's members, from your Board members to other Board members, or from your Board members to their family or friends.

IkonForums^© Predefined Email Templates

PM Notification	Member to member emailing	New Reply Notification	Administrators New User Notification
Invite a Friend Template	Mass Email Template	Email Address Change Request	Send topic page to a friend
Lost Password Step 1	Lost Password Step 2	Registration Validation	Outdated Member Notification

You may view the pre-defined templates default text on this page.

In each template at the very bottom of the email message body you will notice a
"Powered by IkonForums 1.0 (http://www.ikonforums.com/)" link back to our main website. You may remove it if you wish; you would not be breaking any "rules." But, for those of you who've decided to give us recognition for authoring your Forum Software, we Thank You.

Can I create a new template?
No, at least not by this utility. Email templates must be recognized by IkonForums throughout various areas of the Board Software so that they are functional. Creating a new template, recognizing and initiating it, and fulfilling it's desired function requires a lot of coding.

What Content Tags are available?
Here's a list for your reference.
Many of these serve valuable information in email transmission, and should not be modified or removed; especially those Tags represented in RED.
Tags representing your IkonForums^© Board:

1. <#BOARD_ADDRESS#> converts to your boards URL
   • defined in Options - Board Paths
2. <#WEB_ADDRESS#> converts to your website's URL
   • defined in Options - Board Paths
3. <#BOARD_NAME#> converts to your board name
   • defined in Options - Board Options - Board Details
4. <#SIGNATURE#> converts to your board signature
   • defined in Options - Email Options - Default Content

Tags reserved for internal use.

• <#MESSAGE#> converts to email message
  • defined from various Form Input
• <#SENDER_NAME#> converts to Board member's name that sent the email
  • Example: Board invitation from Member (sender)
• <#SENDER_EMAIL#> converts to Board Member's email address
  • Example: Board member's email address included in "Invite A Friend"
• <#CODE#> converts to Unlock Code for Unlock Box via Lost Password retrieval.
• <#THE_LINK#> converts to Unlock Box URL via Lost Password retrieval.
• <#U_NAME#> converts to Member's User Name via Lost Password retrieval, part2.
• <#U_PASS#> converts to Member's New Password via Lost Password retrieval, part2.
• <#MEMBER_NAME#> converts to receiving Member's Name via member to member email
  • when "use email form" is switched on. Options - Email Options - Mail Options (setup)
• <#FROM_NAME#> converts to sending Member's Name via member to member email
  • when "use email form" is switched on. Options - Email Options - Mail Options (setup)
• <#PASSWORD#> converts to Member's Password during Registration Validation
  • if send email to validate registration is Yes.
• <#UNTIL#> converts Registration validation expiration days
  • defined in How long to allow validation via email
• <#THE_LINK#> converts to Activation Link sent in Registration Validation email.
• <#FORUM_NAME#> converts to Forum Name via New Reply Notification.
• <#TOPIC_TITLE#> converts to Topic Title via New Reply Notification.
• <#DATE#> converts to new member registration date via Administrators New User Notification
  • if Registration Notification is activated
• <#TO_NAME#> converts to email recipient in Send topic page to a friend
• <#THE_MESSAGE#> converts to sender' message in Send topic page to a friend
• <#EMAIL#> converts to Member email address associated with account
  • used in Outdated Member Notification
• <#MAN_LINK#> converts to secondary validation link for manual input of required parameters.
  • Example: AOL users.

email templates are stored in: /data/EmailTemplates.pm

(Δ Top)

MIME Types

IkonForums^© MIME List authorizes files of certain type to be attached to Posts.
If the file-type is not listed in the MIME List, IkonForums will reject it and not allow upload to your Board.

IkonForums^© default MIME List contains a wide variety of file-types for:

• Media and Sound
• Image files (wide variety, even .PSD for you PhotoShop enthusiasts)
• Compressed archives
• Text, Rich Text, and even Perl scripts (when uploaded as .pl)
• Full file-types for OASIS OpenDocuments; ie, OpenOffice 2.0(+)
• Microsoft Office (most popular)
• Controlled use of: application/octet-stream (binary) allowed
  certain extensions such as .EXE are forbidden (security and safety measure)

(Δ Top)

Add MIME

If you haven't done so, please enlarge the thumbnail image so that you may familiarize yourself concerning the following discussion.

Currently, IkonForums has four fields of enterable information when adding an Internet Media Type to the MIME List. You can add up to five MIME entries at any one time.

These fields are, in order (left to right):

1. MIME Type (more accurately: Content-Type)
   Must be a valid Internet Media / Content-Type
   text input line
   Default: empty

2. Mime Description
   text input line
   Default: empty

   Tip:
   Keep the description short; it displays underneath the text link in Posts.

3. Mime Image GFX ID
   text input line
   Default: empty

   Each Mime Type has an image associated with it which will be displayed beside the uploaded file. This image must be uploaded to the
   /html/non-cgi/gfx/Default[or Custom Graphics Pack Name]/images/mime
   folder of your skin and an entry with the prefix MIME_ must be added to the GFX properties.

4. Allow use?
   select menu
   Choices: Yes / No
   Default: Yes

• Add These MIME Types
  Submit button
  Appends entries to MIME List

Tip:
Try using the file-type's extension as your MIME Image GFX ID.
Example: Mime Image GFX ID = ext
In Graphic's Area it will be referenced as: MIME_ext
For more information, view the Graphics Section of the IkonForums Skin Tutorial.

(Δ Top)

Edit MIME List

Enlarge thumbnail image to view IkonForums default installed MIMEs Editing a MIME is fairly simple. Hover over the desired field click, and edit. You can update the Content-Type, change your Description, and even disallow the MIMEs usage (Allow use? "No") When editing a GFX Reference ID, make sure you edit it's companion entry in the Appearances & Language: ISIS™ Graphics section. To remove a MIME just delete all fields (set them to empty) Remember to click the submit button Apply these changes at the very bottom of the page to apply your changes.

Global - Edit MIME List

(Δ Top)

Emoticons

Emoticon stands for emotional icon; those cute little smiley faces you see on the Web. They can be static images (stationary) or animated. Animated emoticons usually have the file extension of .GIF while static emoticons can use: .GIF, .PNG, or .JPG. Emoticons are generally small, with sizes ranging from 16x16 pixels to 32x32 pixels (you don't want them too big or they'll no longer remain "cute" but rather become an eye soar).

You have a few methods of adding emoticons to your IkonForums^© Board, you can use your FTP program to upload them to their containing folder: /non-cgi/emoticons, or you can upload the images through your IkonForums^© Control Panel.

You can upload as many emoticons as you desire; however, they will not be usable until you tell IkonForums how to "see" them. To do this, you must define a textual expression that IkonForums can associate with the image. This is done in the topmost area of the emoticon utility.

To aid you with the correct filename, there is a View All Emoticons link that will open a pop up window displaying available images and their filenames.

Emoticons - View All

(Δ Top)

Define emoticon(s)

There are three fields in this table: Text text input line Default: empty Represents the textual expression used in posts to display your smiley. Examples: :) :happy: Insert into Clickable Table? select menu Choices: Yes / No Default: Yes If "Yes" the smiley will be added to the emoticon table visible next to the post message text area. If "No" the smiley will be available for use by manually entering the textual expression. The Emoticon Help pop up window will display the text ↔ image association for the user. Converted To text input line Default: empty This is the filename of the image to be display. Tip: Filenames are case sensitive! Enter them the same way they were uploaded, refer to the View All popup for filename formating.

Emoticons - Define

(Δ Top)

Add emoticon(s)

This is where you can directly upload your emoticons to your IkonForums^© Board. Simply enter the quantity you'd like to upload then in the next screen borwse your computer, select and add. Simple!

*How many emoticons do you want to upload? text input line (numeric) Default: 5 Proceed submit button

Emoticons - Add

Next, select your images to upload.

This table has one row designated per emoticon based on your previous entry of desired images to upload. Each table row entry consists of: File. text input line Default: empty Browse Sumbit button Opens window displaying local folder contents. Select you image and click "OK." Destination text input line Name of image to be stored in your IkonForums Emoticon folder. Default: empty Tip: Leave this empty unless you wish to rename the image. Add to emoticons? This allows you to add the new image directly to the Emoticon Table that is displayed next to each Topic message textarea select menu Choices: Yes / No Default: No Emoticon Code Becomes available if Add to emoticons is set to Yes This is the textual expression to associate with the image text input line Default: Inactive / empty Examples: :) :happy:

Emoticons - Upload

(Δ Top)

Edit emoticon(s)

Please Edit the emoticons below or leave both fields blank to remove. View All Emoticons (link as described at the beginning of this article). Text Textual expressions to associate with image text input line Default: current expression Examples: :) :happy: Insert into Clickable Table? When you aded the image in either Define or Add (as discussed in this article) you made your decision, here you can change it's setting. select menu Choices: Yes / No Default: preset If "Yes" the smiley will be added to the emoticon table visible next to the post message text area. If "No" the smiley will be available for use by manually entering the textual expression. The Emoticon Help pop up window will display the text ↔ image association for the user. Converted to Filename of image Default: predefined Apply these changes submit button Tip: To remove an image, simply clear the Text and Converted To fields, and set Insert Into Clickable Table to No.

Emoticons - Edit

emoticons storage location: /non-cgi/emoticons

(Δ Top)

Quick Reply Emoticons

Quick Reply Emoticon Control
Please choose which 11 emoticons will appear in the quick reply box

You do not have to choose all 11, or any at all, but 11 is the maximum quantity that can be displayed.

Displayed on this page of your IkonForums^© Control Panel are 11 rows of drop-down select menus. The select menu has one built-in option:"Please choose..." followed by a list of icons contained inside your Emoticon Folder (/html/non-cgi/emoticons). Simply start with the top menu, select your emoticon by clicking on it's description. It will then be displayed at the right side of the menu. To add another, move down to the next menu bar and select. To remove an emoticon from the list, select the default "Please choose..." option.

Note:
You must have images in your emoticon folder to use this option. To install emoticons, please reference: Global Settings - Emoticons

(Δ Top)

Help Manager

The IkonForums^© Help Manager allows you to edit existing topic titles and their topic content, as well as remove or add titles and content. Think of a title and it's associated content as help sections.

These entries are stored directly into the Language Files.
The location of this file for the English Language Pack is: /Languages/en/HelpContent.pm

Edit Help Topics

First option is to select the Language File that contains the Help Section you want to edit. If you have more than one Language Pack installed on your IkonForums Board, you will have them as choices in a drop-down menu select list; otherwise it will default to one: English, in which case all you need to do is click the Edit this Help File button.

Language Selection

Current Installed Languages select menu (dynamic) Choices: (included language packs) Default: English

Help Manager - Language Select

Edit Language Help

In IkonForums, a Help Topic Section requires two (2) entries to be made, each entry key must contain the same topic prefix for title and content to be associated together.

• Section Title
• Section Content

Each entry key requires one of the following suffixes:

• _title
• _content

It is by these suffixes that IkonForums knows where to add the content. If you view your Help page via the main navigation help (tab/button/link), you will see a section labeled: Choose a topic. The SECTION_title is added to the Choose a topic menu. This title is a link that navigates to the second part of your section entry: SECTION_content.

SECTION_content contains the descriptive information associated with it's SECTION_title.

Entry KEY Rules

1. Special Characters
   • NOT Allowed, ie. & % : / ; etc.
2. No HTML allowed

Entry CONTENT Rules

1. Special Characters
   • Allowed using HTML Character Codes example: &amp; to output &
2. Basic HTML allowed; ie. <br />, <p>This is a paragraph.</p>

Example:

Entry key: Topic_title
Entry text: Print Topic

Entry key: Topic_content
Entry text: This will display a printer friendly version of the topic suitable for printing. The link can be found at the bottom of each topic.

Displays on your Help Page...

Choose a topic: "Print Topic"

Topic Section: "This will display a printer friendly version of the topic suitable for printing. The link can be found at the bottom of each topic."

(Δ Top)