Fast, Flexible & Easy
Menulab home > Discussions >  Documentation 

Discussions Logo Discussions Documentation


Member Description
Most Important
public enum mlMode Menulab.Discussions.ModeEnum {get;set;} Default is Forum. This property will set Discussions in either full fledged forum mode or in page level comment track mode.
public enum mlForumLayout Menulab.Discussions.ForumLayoutEnum {get;set;} Default is Smart. Discussions support 2 different forum layouts, smart & standard. Set to smart for superior navigation. Set to standard if you have only little horizontal space and/or want to show users what they are already experienced with.
public enum mlDiscussionLayout Menulab.Discussions.DiscussionLayoutEnum {get;set;} Default is Hierarchy. A forum discussion or a comment track can be displayed in 3 different layouts, either Hierarchy or Threads or Flat. Hierarchy makes it easy to see who replies to who. Flat orders the replies after the time they are added. Threads is a compromise between Hierarchy and Flat ordering each reply like Flat but creates a header for each reply showing the reply path.
public property mlIncludeLoginControls Boolean {get;set;} Default is true. Default true for forum mode but default false for comments mode.
public property mlForumName String {get;set;} Default is Discussions. Set to any name you would like for your forum.
public property mlImageUrls.Miscellaneous.DiscussionsLogo string {get;set;} Default is null. Set to url of your own logo.
 
Database
Note that Discussions embed its own database so that storage is working out-of-the-box. However you can use the properties below to connect to your own database.
public enum mlDatabaseEnum Menulab.Discussions.DatabaseEnum {get;set;} Default is BuiltInCompactEdition. Indicate what database server you are using. Supported databases are : SSCE (default), SQLServer & MySQL (5.0 or higher).
public property mlConnectionString String {get;set;} Default is null. Use this property to point Discussions to use your own database (tables are automatically created first time Discussions connect). Value must be null if you use BuiltInCompactEdition
 
Email Server Integration
Note that Discussions is default connected to a Discussions dedicated Email Server so that email is working out-of-the-box. However you can use the properties below to connect Discussions to your own email server.
public property mlEmail.SmtpServer String {get;set;} Default is mail.menulab.com.
public property mlEmail.SmtpPort Integer {get;set;} Default is 25.
public property mlEmail.SmtpUsername String {get;set;} Default is discussions@menulab.com.
public property mlEmail.SmtpPassword String {get;set;} Default is null.
public property mlEmail.FromAddress String {get;set;} Default is null.
 
Facebook Integration
Note that Discussions is default connected to a Discussions dedicated Facebook Service so that facebook is working out-of-the-box. However you use the properties below to connect Discussions to your own Facebook Application.
public property mlFacebookAppID String {get;set;} Default is null.
public property mlFacebookAppSecret String {get;set;} Default is null.
 
Menu in smart forum
public property mlSmartForumAutoCollapseLevel Integer {get;set;} Default is 2. In smart layout, this property determines how deep the forum is default expanding upon page load - the smart forum menu will auto collapse to this level (except path to current discussion). Set to zero to avoid auto collapsing.
public property mlSmartForumMenuWidth Integer {get;set;} Default is 400. The wider the smart forum menu the better for the menu but the lesser space for current discussion.
public property mlHierarchyIndent Integer {get;set;} Default is 60. Each sub level in smart forum menu is moved to the right this number of pixels
 
Nickpics
public property mlNickpicFolderUrl String {get;set;} Default is _menulab/Discussions/Nickpics. If you want to keep your nickpics at another location, you can set it here. Note that Server.MapPath is applied.
public property mlNickpicWidth Integer {get;set;} Default is 80. Value is in pixel. Nickpics are displayed various places throughout the application most notably in each post.
 
Miscellaneous
public property mlSearchMaximumBodyLength Integer {get;set;} Default is -1. The search result will show snippets from the posts for each result, here set how how many characters is maximum allowed in each snippet. Set to -1 to allow full post bodies.
public property mlDateTimeFormat String {get;set;} Default is dd-MMM-yyyy HH:mm. Datetime are displayed various places, use this property to set the format.
Eventually see DateTime format specifiers @ MSDN.
public property mlDiscussionsWidth Integer {get;set;} Default is -1. Default DiscussionsWidth is set by mlCssClasses.Container (which will expand Discussions control to horizontally fill parent container), however mlDiscussionsWidth will override DiscussionsWidth if set different from -1.
public property mlPageIdent String {get;set;} Default is null. Used only in Comments mode to explicitly identify a comment track. If set to null, the PageIdent will be automatically created as the page name. Use the PageIdent to share a comment track between pages or to divide comment tracks based on query string keys. Also the comment track identifier will show up in any Forum "Import Comments" if the Forum shares the database of the comment track.
public property mlQueryStringPrefix String {get;set;} Default is ml-d-. If you have multiple Discussions instances on the same page, you need to set mlQueryStringPrefix to a unique value for each instance. This is done in several of Discussions examples here on menulab.com.
public property mlEnableSmartBookmarks Boolean {get;set;} Default is false. Default false in Forum mode and default true in Comments mode. If set to true the page will jump to the top of the Discussions container upon most actions. If set to false the page will jump to the top upon most actions.
public property mlFocusLoginControlsBeforeLogin Boolean {get;set;} Default is true. Default true in Forum mode and default false in Comments mode
public property mlBuiltInCompactEditionFolderUrl String {get;set;} Default is _menulab/Discussions. Sets the path offset from Request.ApplicationPath there Discussions will create the BuiltInCompactEdition database.
This property main use is to create multiple forums with separate databases like here on menulab.com there all the example fora share one database BUT one database for each session - the example fora therefore use this property as :
mlDiscussions.mlBuiltInCompactEditionFolderUrl = "_menulab/Discussions/" + Session.SessionID;
public property mlLogoDisplay Boolean {get;set;} Default is true.
public property mlLogoNavigateUrl String {get;set;} Default is Request.Url.AbsolutePath.
public enum mlUserHtmlLayout UserHtmlLayoutEnum {get;set;} Default is UserHtmlLayoutEnum.NotSet. Sets whether to display user information in each post vertical to the left or horizontally at the top. Keeping the default value NotSet will let Discussions choose Vertical for standard forum layout and Horizontal for smart forum layout.
public property mlForumLayoutIsLocked Boolean {get;set;} Default is false. Then set to false (default) users can freely switch between Standard & Smart forum layout modes. Then set to true, users cannot switch between Standard & Smart mode but are forced to use the forum layout mode set by Administrator.
 
Configuration - who can do what
public enum mlConfig.RootCategoriesCanBeAddedBy Menulab.Discussions.RootCategoriesCanBeAddedByEnum {get;set;} Default is Admins.
public enum mlConfig.CategoriesCanBeAddedBy Menulab.Discussions.CategoriesCanBeAddedByEnum {get;set;} Default is Moderators.
public enum mlConfig.CategoriesCanBeDeletedBy Menulab.Discussions.CategoriesCanBeDeletedByEnum {get;set;} Default is Moderators.
public enum mlConfig.CategoriesCanBeEditedBy Menulab.Discussions.CategoriesCanBeEditedByEnum {get;set;} Default is Moderators.
public enum mlConfig.RootDiscussionsCanBeAddedBy Menulab.Discussions.RootDiscussionsCanBeAddedByEnum {get;set;} Default is Admins.
public enum mlConfig.DiscussionsCanBeAddedBy Menulab.Discussions.DiscussionsCanBeAddedByEnum {get;set;} Default is LoggedInUsers.
public enum mlConfig.DiscussionsCanBeDeletedBy Menulab.Discussions.DiscussionsCanBeDeletedByEnum {get;set;} Default is Moderators.
public enum mlConfig.DiscussionsCanBeEditedBy Menulab.Discussions.DiscussionsCanBeEditedByEnum {get;set;} Default is Moderators.
public enum mlConfig.DiscussionsCanBeStickedBy Menulab.Discussions.DiscussionsCanBeStickedByEnum {get;set;} Default is Moderators.
public enum mlConfig.RepliesCanBeAddedBy Menulab.Discussions.RepliesCanBeAddedByEnum {get;set;} Default is LoggedInUsers. In Comments mode default is .Guests.
public enum mlConfig.RepliesCanBeDeletedBy Menulab.Discussions.RepliesCanBeDeletedByEnum {get;set;} Default is Moderators.
public enum mlConfig.RepliesCanBeEditedBy Menulab.Discussions.RepliesCanBeEditedByEnum {get;set;} Default is Moderators.
public enum mlConfig.RepliesCanBeMovedBy Menulab.Discussions.RepliesCanBeMovedByEnum {get;set;} Default is Admins.
public enum mlConfig.RepliesCanBeReportedBy Menulab.Discussions.RepliesCanBeReportedByEnum {get;set;} Default is LoggedInUsers.
Configuration - post elements
public property mlConfig.Posts.IncludeVoting Boolean {get;set;} Default is true. Default true in both Forum and Comments mode (before version 1.2 it was default false in Comments mode).
public property mlConfig.Posts.IncludeReplying Boolean {get;set;} Default is true.
public property mlConfig.Posts.IncludeReporting Boolean {get;set;} Default is true.
public property mlConfig.Posts.IncludeSignature Boolean {get;set;} Default is mlDiscussions.mlIncludeLoginControls. Default signatures will be displayed if there are login controls, however you can force it the way you want with either true or false.
public property mlConfig.Posts.IncludeTimestamp Boolean {get;set;} Default is true.
Configuration - Miscellaneous
public enum mlConfig.CaptchaIsOnFor Menulab.Discussions.CaptchaIsOnForEnum {get;set;} Default is LoggedInUsers.
public property mlConfig.FacebookIsDefaultSelected Boolean {get;set;} Default is false.
public property mlConfig.GuestCanPM Boolean {get;set;} Default is false.
public property mlConfig.GuestCanVote Boolean {get;set;} Default is false.
public property mlConfig.HotTopicReplyCount Integer {get;set;} Default is 15. If there are 15 replies in a discussion ..
public property mlConfig.HotTopicDayCount Integer {get;set;} Default is 30. .. over the last 30 days, then the discussion is marked as hot.
public property mlConfig.MaxUploadFileSize Integer {get;set;} Default is 10. Value is in KB.
 
RichTextBoxes
Discussions is using several RichTextBox'es to allow rich user input. Each RichTextBox can be configured independently of the others.
  • mlRichTextBoxes.AddDiscussion
  • mlRichTextBoxes.AddPoll
  • mlRichTextBoxes.AddReply
  • mlRichTextBoxes.EditReply
  • mlRichTextBoxes.EditSmartMenuHome
  • mlRichTextBoxes.PersonalMessage
  • mlRichTextBoxes.ProfileSignature
To get help on how to configure a RichTextBox, please see RichTextBox documentation & examples.
 
Images
Discussions is using many different symbol images thoughout the application. Default all images are loaded from the Discussions assembly, however you can use your own images for any one of them you like by simply setting the appropriate image property to the url of your custom image.
public property mlImageUrls.Breadcrumb.Background String {get;set;} Default is null. Set to null to retrieve the default image from the assembly.
public property mlImageUrls.Discussion.VoteDown String {get;set;} Default is null.
public property mlImageUrls.Discussion.VoteUp String {get;set;} Default is null.
public property mlImageUrls.ForumActions.HaveNewReplies String {get;set;} Default is null.
public property mlImageUrls.ForumActions.NewCategory String {get;set;} Default is null.
public property mlImageUrls.ForumActions.NewCategory_hover String {get;set;} Default is null.
public property mlImageUrls.ForumActions.NewDiscussion String {get;set;} Default is null.
public property mlImageUrls.ForumActions.NewDiscussion_hover String {get;set;} Default is null.
public property mlImageUrls.ForumActions.NewPoll String {get;set;} Default is null.
public property mlImageUrls.ForumActions.NewPoll_hover String {get;set;} Default is null.
public property mlImageUrls.ForumActions.NewPost String {get;set;} Default is null.
public property mlImageUrls.ForumActions.NewPost_hover String {get;set;} Default is null.
public property mlImageUrls.Header.AdminConfig String {get;set;} Default is null.
public property mlImageUrls.Header.AdminConfig_hover String {get;set;} Default is null.
public property mlImageUrls.Header.HandlePageComments String {get;set;} Default is null.
public property mlImageUrls.Header.HandlePageComments_hover String {get;set;} Default is null.
public property mlImageUrls.Header.HomeLink String {get;set;} Default is null.
public property mlImageUrls.Header.UserList String {get;set;} Default is null.
public property mlImageUrls.Header.UserList_hover String {get;set;} Default is null.
public property mlImageUrls.Home.Background String {get;set;} Default is null.
public property mlImageUrls.Home.Comment String {get;set;} Default is null.
public property mlImageUrls.Home.NewReplies String {get;set;} Default is null.
public property mlImageUrls.Home.Notify String {get;set;} Default is null.
public property mlImageUrls.Home.Reply String {get;set;} Default is null.
public property mlImageUrls.Menu.AddNew String {get;set;} Default is null.
public property mlImageUrls.Menu.AddNew_hover String {get;set;} Default is null.
public property mlImageUrls.Menu.Category String {get;set;} Default is null.
public property mlImageUrls.Menu.CategoryBackground_l1 String {get;set;} Default is null.
public property mlImageUrls.Menu.MarkDefault String {get;set;} Default is null.
public property mlImageUrls.Menu.MarkDefaultClosed String {get;set;} Default is null.
public property mlImageUrls.Menu.MarkDefaultHot String {get;set;} Default is null.
public property mlImageUrls.Menu.MarkPoll String {get;set;} Default is null.
public property mlImageUrls.Menu.MarkPollClosed String {get;set;} Default is null.
public property mlImageUrls.Menu.MarkPollHot String {get;set;} Default is null.
public property mlImageUrls.Menu.NewCategory_SmartMenu_Hot String {get;set;} Default is null.
public property mlImageUrls.Menu.NewCategory_SmartMenu_Reg String {get;set;} Default is null.
public property mlImageUrls.Menu.NewDiscussion_SmartMenu_Hot String {get;set;} Default is null.
public property mlImageUrls.Menu.NewDiscussion_SmartMenu_Reg String {get;set;} Default is null.
public property mlImageUrls.Menu.NewPoll_SmartMenu_Hot String {get;set;} Default is null.
public property mlImageUrls.Menu.NewPoll_SmartMenu_Reg String {get;set;} Default is null.
public property mlImageUrls.Menu.NewPost_SmartMenu_Dis String {get;set;} Default is null.
public property mlImageUrls.Menu.NewPost_SmartMenu_Hot String {get;set;} Default is null.
public property mlImageUrls.Menu.NewPost_SmartMenu_Reg String {get;set;} Default is null.
public property mlImageUrls.Menu.NewRepliesIndication String {get;set;} Default is null.
public property mlImageUrls.Menu.Notify String {get;set;} Default is null.
public property mlImageUrls.Menu.ReplyCount String {get;set;} Default is null.
public property mlImageUrls.Menu.StickyHeader String {get;set;} Default is null.
public property mlImageUrls.Menu.StickyItem String {get;set;} Default is null.
public property mlImageUrls.Menu.ToggleClosed String {get;set;} Default is null.
public property mlImageUrls.Menu.ToggleOpen String {get;set;} Default is null.
public property mlImageUrls.Menu.TopicCount String {get;set;} Default is null.
public property mlImageUrls.Menu.ViewCount String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.BackButton String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.BackButton_hover String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.DefaultUser String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.DiscussionsLogo String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.HomepageEditButton String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.HomepageEditButton_hover String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.ManageButton String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.ManageButton_hover String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.SearchButton String {get;set;} Default is null.
public property mlImageUrls.Miscellaneous.SearchButton_hover String {get;set;} Default is null.
public property mlImageUrls.PersonalMessages.PersonalMessagesDelete String {get;set;} Default is null.
public property mlImageUrls.PersonalMessages.PersonalMessagesIcon String {get;set;} Default is null.
public property mlImageUrls.PersonalMessages.PersonalMessagesNew String {get;set;} Default is null.
public property mlImageUrls.PersonalMessages.PersonalMessagesOld String {get;set;} Default is null.
public property mlImageUrls.User.LoginButton String {get;set;} Default is null.
public property mlImageUrls.User.LoginButton_hover String {get;set;} Default is null.
public property mlImageUrls.User.LogoutButton String {get;set;} Default is null.
public property mlImageUrls.User.LogoutButton_hover String {get;set;} Default is null.
public property mlImageUrls.User.ProfileEdit String {get;set;} Default is null.
public property mlImageUrls.User.ProfileEdit_hover String {get;set;} Default is null.
 
Css
Discussions is using CSS to style many different parts of the application. You can change the default style of most elements by setting the appropriate property to your own custom CSS class.
public property mlCssClasses.Breadcrumb.CurrentCrumb String {get;set;} Default is null. Set to null to use the default CSS class delivered by the assembly.
public property mlCssClasses.Breadcrumb.ParentCrumb String {get;set;} Default is null.
public property mlCssClasses.Breadcrumb.RootCrumb String {get;set;} Default is null.
public property mlCssClasses.Breadcrumb.Splitter String {get;set;} Default is null.
public property mlCssClasses.Header.HomeLink String {get;set;} Default is null.
public property mlCssClasses.Header.LogoImage String {get;set;} Default is null.
public property mlCssClasses.Header.LogoLink String {get;set;} Default is null.
public property mlCssClasses.Header.PageTitle String {get;set;} Default is null.
public property mlCssClasses.Header.RowBottom String {get;set;} Default is null.
public property mlCssClasses.Header.RowTop String {get;set;} Default is null.
public property mlCssClasses.Home.Description String {get;set;} Default is null.
public property mlCssClasses.Home.H1 String {get;set;} Default is null.
public property mlCssClasses.Home.H2 String {get;set;} Default is null.
public property mlCssClasses.Home.LoggedIn String {get;set;} Default is null.
public property mlCssClasses.Menu.CategoryRow_level1 String {get;set;} Default is null.
public property mlCssClasses.Menu.CreatedBy String {get;set;} Default is null.
public property mlCssClasses.Menu.HomeLink String {get;set;} Default is null.
public property mlCssClasses.Menu.HomeLink_selected String {get;set;} Default is null.
public property mlCssClasses.Menu.LastActivity String {get;set;} Default is null.
public property mlCssClasses.Menu.NotifyColumn String {get;set;} Default is null.
public property mlCssClasses.Menu.ReplyCountColumn String {get;set;} Default is null.
public property mlCssClasses.Menu.ReplyCountColumn_level1 String {get;set;} Default is null.
public property mlCssClasses.Menu.SmartItemRow String {get;set;} Default is null.
public property mlCssClasses.Menu.SmartItemRowHover String {get;set;} Default is null.
public property mlCssClasses.Menu.StandardListHeaderCell String {get;set;} Default is null.
public property mlCssClasses.Menu.StandardListHeaderRow String {get;set;} Default is null.
public property mlCssClasses.Menu.StandardListItemCell String {get;set;} Default is null.
public property mlCssClasses.Menu.StandardListItemRow String {get;set;} Default is null.
public property mlCssClasses.Menu.StandardListTable String {get;set;} Default is null.
public property mlCssClasses.Menu.TitleColumn String {get;set;} Default is null.
public property mlCssClasses.Menu.TitleLink_category String {get;set;} Default is null.
public property mlCssClasses.Menu.TitleLink_category_level1 String {get;set;} Default is null.
public property mlCssClasses.Menu.TitleLink_discussion String {get;set;} Default is null.
public property mlCssClasses.Menu.TitleLink_discussion_selected String {get;set;} Default is null.
public property mlCssClasses.Menu.TopicCountColumn String {get;set;} Default is null.
public property mlCssClasses.Menu.TopicCountColumn_level1 String {get;set;} Default is null.
public property mlCssClasses.Menu.ViewCountColumn String {get;set;} Default is null.
public property mlCssClasses.Menu.ViewCountColumn_level1 String {get;set;} Default is null.

Terms & Conditions    |    Privacy Policy    |    Sitemap    |    Copyright © Menulab 2012. All rights reserved.