diff --git a/docs/create.sql b/docs/create.sql index 24ac5d948..c2e82e41e 100644 --- a/docs/create.sql +++ b/docs/create.sql @@ -319,14 +319,14 @@ INSERT INTO help VALUES (1,'US English','Add','Page','Think of pages as containe INSERT INTO help VALUES (2,'US English','Edit','Page','Title\r\nSee Add Page for details.\r\n\r\nMeta Tags\r\nSee Add Page for details.\r\n\r\nStyle\r\nBy default, when you create a page, it inherits a few traits from its parent. One of those traits is style. Choose from the list of styles if you would like to change the appearance of this page. See Add Style for more details.\r\n\r\nIf you check the box next to the style pull-down menu, all of the pages below this page will take on the style you\'ve chosen for this page.\r\n\r\nPage URL\r\nWhen you create a page a url for the page is generated based on the page title. If you are unhappy with the url that was chosen, you can change it here.\r\n\r\nOwner\r\nThe owner of a page is usually the person who created the page. If you\'d like to give ownership of a page to a different content manager, then change the name here. Be careful though, once you change ownership of the page, you won\'t be able to get it back unless you are an administrator.\r\n\r\nOwner can view?\r\nCan the owner view the page or not?\r\n\r\nOwner can edit?\r\nCan the owner edit the page or not? Be careful, if you decide that the owner cannot edit the page and you do not belong to the page group, then you\'ll lose the ability to edit this page.\r\n\r\nGroup\r\nA group is assigned to every page for additional privilege control. Pick a group from the pull-down menu.\r\n\r\nGroup can view?\r\nCan members of this group view this page?\r\n\r\nGroup can edit?\r\nCan members of this group edit this page?\r\n\r\nAnybody can view?\r\nCan any visitor or member regardless of the group and owner view this page?\r\n\r\nAnybody can edit?\r\nCan any visitor or member regardless of the group and owner edit this page?\r\n\r\n','9'); INSERT INTO help VALUES (3,'US English','Delete','Page','Deleting a page can create a big mess if you are uncertain about what you are doing. When you delete a page you are also deleting the content it contains, all sub-pages connected to this page, and all the content they contain. Be certain that you have already moved all the content you wish to keep before you delete a page.\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); INSERT INTO help VALUES (4,'US English','Delete','Style','When you delete a style all pages using that style will be reverted to the fail safe (default) style. To ensure uninterrupted viewing, you should be sure that no pages are using a style before you delete it.\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); -INSERT INTO help VALUES (5,'US English','Add','User','See Manage Users for additional details.\r\n\r\nUsername\r\nUsername is a unique identifier for a user. Sometimes called a handle, it is also how the user will be known on the site. (Note: Administrators have unlimited power in the WebGUI system. This also means they are capable of breaking the system. If you rename or create a user, be careful not to use a username already in existance.)\r\n\r\nPassword\r\nA password is used to ensure that the user is who s/he says s/he is.\r\n\r\nEmail Address\r\nThe user\'s email address. This must only be specified if the user will partake in functions that require email.\r\n\r\nICQ UIN\r\nThe ICQ UIN is the \"User ID Number\" on the ICQ network. ICQ is a very popular instant messaging platform.\r\n\r\nGroups\r\nGroups displays which groups the user is in. Groups that are highlighted are groups that the user is assigned to. Those that are not highlighted are other groups that can be assigned. Note that you must hold down CTRL to select multiple groups.','0'); -INSERT INTO help VALUES (6,'US English','Edit','User','Username\r\nSee Add User for details.\r\n\r\nPassword\r\nSee Add User for details.\r\n\r\nEmail Address\r\nSee Add User for details.\r\n\r\nICQ UIN\r\nSee Add User for details.\r\n\r\nGroups\r\nSee Add User for details.\r\n\r\n','0'); +INSERT INTO help VALUES (5,'US English','Add','User','See Manage Users for additional details.\r\n\r\nUsername\r\nUsername is a unique identifier for a user. Sometimes called a handle, it is also how the user will be known on the site. (Note: Administrators have unlimited power in the WebGUI system. This also means they are capable of breaking the system. If you rename or create a user, be careful not to use a username already in existance.)\r\n\r\nPassword\r\nA password is used to ensure that the user is who s/he says s/he is.\r\n\r\nAuthentication Method\r\nSee Edit Settings for details.\r\n\r\nLDAP URL\r\nSee Edit Settings for details.\r\n\r\nConnect DN\r\nThe Connect DN is the cn (or common name) of a given user in your LDAP database. It should be specified as cn=John Doe. This is, in effect, the username that will be used to authenticate this user against your LDAP server.\r\n\r\nEmail Address\r\nThe user\'s email address. This must only be specified if the user will partake in functions that require email.\r\n\r\nICQ UIN\r\nThe ICQ UIN is the \"User ID Number\" on the ICQ network. ICQ is a very popular instant messaging platform.\r\n\r\nGroups\r\nGroups displays which groups the user is in. Groups that are highlighted are groups that the user is assigned to. Those that are not highlighted are other groups that can be assigned. Note that you must hold down CTRL to select multiple groups.','0'); +INSERT INTO help VALUES (6,'US English','Edit','User','Username\r\nSee Add User for details.\r\n\r\nPassword\r\nSee Add User for details.\r\n\r\nAuthentication Method\r\nSee Edit Settings for details.\r\n\r\nLDAP URL\r\nSee Edit Settings for details.\r\n\r\nConnect DN\r\nSee Add User for details.\r\n\r\nEmail Address\r\nSee Add User for details.\r\n\r\nICQ UIN\r\nSee Add User for details.\r\n\r\nGroups\r\nSee Add User for details.\r\n\r\n','12'); INSERT INTO help VALUES (7,'US English','Delete','User','There is no need to ever actually delete a user. If you are concerned with locking out a user, then simply change their password. If you truely wish to delete a user, then please keep in mind that there are consequences. If you delete a user any content that they added to the site via widgets (like message boards and user contributions) will remain on the site. However, if another user tries to visit the deleted user\'s profile they will get an error message. Also if the user ever is welcomed back to the site, there is no way to give him/her access to his/her old content items except by re-adding the user to the users table manually.\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); INSERT INTO help VALUES (8,'US English','Manage','User','Users are the accounts in the system that are given rights to do certain things. There are two default users built into the system: Admin and Visitor.\r\n\r\nAdmin\r\nAdmin is exactly what you\'d expect. It is a user with unlimited rights in the WebGUI environment. If it can be done, this user has the rights to do it.\r\n\r\nVisitor\r\nVisitor is exactly the opposite of Admin. Visitor has no rights what-so-ever. By default any user who is not logged in is seen as the user Visitor.','0'); INSERT INTO help VALUES (9,'US English','Manage','Style','Styles are used to manage the look and feel of your WebGUI pages. With WebGUI, you can have an unlimited number of styles, so your site can take on as many looks as you like. You could have some pages that look like your company\'s brochure, and some pages that look like Yahoo!®. You could even have some pages that look like pages in a book. Using style management, you have ultimate control over all your designs.\r\n\r\nThere are three styles built in to WebGUI: Fail Safe, Plain Black Software, and Yahoo!®. These styles are not meant to be edited, but rather to give you samples of what\'s possible.\r\n\r\nFail Safe\r\nWhen you delete a style that is still in use on some pages, the Fail Safe style will be applied to those pages. This style has a white background and simple navigation.\r\n\r\nPlain Black Software\r\nThis is the simple design used on the Plain Black Software site.\r\n\r\nYahoo!®\r\nThis is the design of the Yahoo!® site. (Yahoo!® has not given us permission to use their design. It is simply an example.)','0'); INSERT INTO help VALUES (10,'US English','Manage','Group','Groups are used to subdivide privileges and responsibilities within the WebGUI system. For instance, you may be building a site for a classroom situation. In that case you might set up a different group for each class that you teach. You would then apply those groups to the pages that are designed for each class.\r\n\r\nThere are four groups built into WebGUI. They are Admins, Content Managers, Visitors, and Registered Users.\r\n\r\nAdmins\r\nAdmins are users who have unlimited privileges within WebGUI. A user should only be added to the admin group if they oversee the system. Usually only one to three people will be added to this group.\r\n\r\nContent Managers\r\nContent managers are users who have privileges to add, edit, and delete content from various areas on the site. The content managers group should not be used to control individual content areas within the site, but to determine whether a user can edit content at all. You should set up additional groups to separate content areas on the site.\r\n\r\nRegistered Users\r\nWhen users are added to the system they are put into the registered users group. A user should only be removed from this group if their account is deleted or if you wish to punish a troublemaker.\r\n\r\nVisitors\r\nVisitors are users who are not logged in using an account on the system. Also, if you wish to punish a registered user you could remove him/her from the Registered Users group and insert him/her into the Visitors group.','0'); INSERT INTO help VALUES (11,'US English','Edit','Style','Style Name\r\nSee Add Style for details.\r\n\r\nHeader\r\nSee Add Style for details.\r\n\r\nFooter\r\nSee Add Style for details.\r\n\r\nStyle Sheet\r\nSee Add Style for details.\r\n\r\n','18,19'); -INSERT INTO help VALUES (12,'US English','Edit','Settings','Settings are items that allow you to adjust WebGUI to your particular needs.\r\n\r\nPath to WebGUI Extras\r\nThe web-path to the directory containing WebGUI images and javascript files.\r\n\r\nSession Timeout\r\nThe time (in seconds) that a user session remains active (before needing to log in again). This timeout is reset each time a visitor hits a page. Therefore if you set the timeout for 8 hours, a user would have to log in again if s/he hadn\'t visited the site for 8 hours.\r\n\r\n1800 = half hour\r\n3600 = 1 hour\r\n28000 = 8 hours\r\n86400 = 1 day\r\n604800 = 1 week\r\n1209600 = 2 weeks\r\n\r\nMaximum Attachment Size\r\nThe maximum size of files allowed to be uploaded to this site. This applies to all widgets that allow uploaded files and images (like Article and User Contributions). This size is measured in kilobytes.\r\n\r\nWeb Attachment Path\r\nThe web-path of the directory where attachments are to be stored.\r\n\r\nServer Attachment Path\r\nThe local path of the directory where attachments are to be stored. (Perhaps /var/www/public/uploads) Be sure that the web server has the rights to write to that directory.\r\n\r\nSMTP Server\r\nThis is the address of your local mail server. It is needed for all features that use the Internet email system (such as password recovery).\r\n\r\nCompany Name\r\nThe name of your company. It will appear on all emails and anywhere you use the Company Name macro.\r\n\r\nCompany Email Address\r\nA general email address at your company. This is the address that all automated messages will come from. It can also be used via the WebGUI macro system.\r\n\r\nCompany URL\r\nThe primary URL of your company. This will appear on all automated emails sent from the WebGUI system. It is also available via the WebGUI macro system.\r\n\r\n\r\n','19'); +INSERT INTO help VALUES (12,'US English','Edit','Settings','Settings are items that allow you to adjust WebGUI to your particular needs.\r\n\r\nPath to WebGUI Extras\r\nThe web-path to the directory containing WebGUI images and javascript files.\r\n\r\nMaximum Attachment Size\r\nThe maximum size of files allowed to be uploaded to this site. This applies to all widgets that allow uploaded files and images (like Article and User Contributions). This size is measured in kilobytes.\r\n\r\nWeb Attachment Path\r\nThe web-path of the directory where attachments are to be stored.\r\n\r\nServer Attachment Path\r\nThe local path of the directory where attachments are to be stored. (Perhaps /var/www/public/uploads) Be sure that the web server has the rights to write to that directory.\r\n\r\nCompany Name\r\nThe name of your company. It will appear on all emails and anywhere you use the Company Name macro.\r\n\r\nCompany Email Address\r\nA general email address at your company. This is the address that all automated messages will come from. It can also be used via the WebGUI macro system.\r\n\r\nCompany URL\r\nThe primary URL of your company. This will appear on all automated emails sent from the WebGUI system. It is also available via the WebGUI macro system.\r\n\r\nAuthentication Method (default)\r\nWhat should the default authentication method be for new accounts that are created? The two available options are WebGUI and LDAP. WebGUI authentication means that the users will authenticate against the username and password stored in the WebGUI database. LDAP authentication means that users will authenticate against an external LDAP server.\r\n\r\nNote: Authentication settings can be customized on a per user basis.\r\n\r\nLDAP URL (default)\r\nThe default url to your LDAP server. The LDAP URL takes the form of ldap://[server]:[port]/[base DN]. Example: ldap://ldap.mycompany.com:389/o=MyCompany.\r\n\r\nLDAP Identity\r\nThe LDAP Identity is the unique identifier in the LDAP server that the user will be identified against. Often this field is shortname, which takes the form of first initial + last name. Example: jdoe. Therefore if you specify the LDAP identity to be shortname then Jon Doe would enter jdoe during the registration process.\r\n\r\nLDAP Identity Name\r\nThe label used to describe the LDAP Identity to the user. For instance, some companies use an LDAP server for their proxy server users to authenticate against. In the documentation or training already provided to their users, the LDAP identity is known as their Web Username. So you could enter that label here for consitency.\r\n\r\nLDAP Password Name\r\nJust as the LDAP Identity Name is a label, so is the LDAP Password Name. Use this label as you would LDAP Identity Name.\r\n\r\nSession Timeout\r\nThe time (in seconds) that a user session remains active (before needing to log in again). This timeout is reset each time a visitor hits a page. Therefore if you set the timeout for 8 hours, a user would have to log in again if s/he hadn\'t visited the site for 8 hours.\r\n\r\n1800 = half hour\r\n3600 = 1 hour\r\n28000 = 8 hours\r\n86400 = 1 day\r\n604800 = 1 week\r\n1209600 = 2 weeks\r\n\r\nSMTP Server\r\nThis is the address of your local mail server. It is needed for all features that use the Internet email system (such as password recovery).\r\n\r\n\r\n','19'); INSERT INTO help VALUES (13,'US English','Edit','Group','Group Name\r\nSee Add Group for details.\r\n\r\nDescription\r\nSee Add Group for details.\r\n','0'); INSERT INTO help VALUES (14,'US English','Delete','Widget','This function permanently deletes the selected widget from a page. If you are unsure whether you wish to delete this content you may be better served to cut the content to the clipboard until you are certain you wish to delete it.\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); INSERT INTO help VALUES (15,'US English','Delete','Group','As the function suggests you\'ll be deleting a group and removing all users from the group. Be careful not to orphan users from pages they should have access to by deleting a group that is in use.\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); @@ -334,7 +334,7 @@ INSERT INTO help VALUES (16,'US English','Add','Style','Styles are WebGUI macro INSERT INTO help VALUES (17,'US English','Add','Group','See Manage Group for a description of grouping functions and the default groups.\r\n\r\nGroup Name\r\nA name for the group. It is best if the name is descriptive so you know what it is at a glance.\r\n\r\nDescription\r\nA longer description of the group so that other admins and content managers (or you if you forget) will know what the purpose of this group is.','0'); INSERT INTO help VALUES (22,'US English','Edit','SQL Report','Title\r\nSee Add SQL Report for details.\r\n\r\nDisplay Title?\r\nSee Add SQL Report for details.\r\n\r\nProcess Macros\r\nSee Add SQL Report for details.\r\n\r\nDescription\r\nSee Add SQL Report for details.\r\n\r\nTemplate\r\nSee Add SQL Report for details.\r\n\r\nQuery\r\nSee Add SQL Report for details.\r\n\r\nDSN\r\nSee Add SQL Report for details.\r\n\r\nDatabase User\r\nSee Add SQL Report for details.\r\n\r\nDatabase Password\r\nSee Add SQL Report for details.\r\n\r\nConvert carriage returns?\r\nSee Add SQL Report for details.\r\n\r\n','19,14,21'); INSERT INTO help VALUES (18,'US English','Using','Style Sheets','Cascading Style Sheets (CSS) are a great way to manage the look and feel of any web site. They are used extensively in WebGUI.\r\n\r\nIf you are unfamiliar with how to use CSS, Plain Black Software provides training classes on XHTML and CSS. Alternatively, Bradsoft makes an excellent CSS editor called Top Style.\r\n\r\nThe following is a list of classes used to control the look of WebGUI:\r\n\r\nA\r\nThe links throughout the style.\r\n\r\nBODY\r\nThe default setup of all pages within a style.\r\n\r\nH1\r\nThe headers on every page.\r\n\r\n.accountOptions\r\nThe links that appear under the login and account update forms.\r\n\r\n.adminBar \r\nThe bar that appears at the top of the page when you\'re in admin mode.\r\n\r\n.boardMenu \r\nThe menu on the message boards.\r\n\r\n.boardMessage \r\nThe full message text.\r\n\r\n.boardTitle \r\nThe title of the message board.\r\n\r\n.content\r\nThe main content area on all pages of the style.\r\n\r\n.crumbTrail \r\nThe crumb trail (if you\'re using that macro).\r\n\r\n.eventTitle \r\nThe title of an individual event.\r\n\r\n.faqQuestion\r\nAn F.A.Q. question. To distinguish it from an answer.\r\n\r\n.formDescription \r\nThe tags on all forms next to the form elements. \r\n\r\n.formSubtext \r\nThe tags below some form elements.\r\n\r\n.highlight \r\nDenotes a highlighted item, such as which message you are viewing within a list.\r\n\r\n.horizontalMenu \r\nThe horizontal menu (if you use a horizontal menu macro).\r\n\r\n.loginBox\r\nThe login box macro.\r\n\r\n.pagination \r\nThe Previous and Next links on pages with pagination.\r\n\r\n.pollAnswer \r\nAn answer on a poll.\r\n\r\n.pollColor \r\nThe color of the percentage bar on a poll.\r\n\r\n.pollQuestion \r\nThe question on a poll.\r\n\r\n.tableData \r\nThe data rows on things like message boards and user contributions.\r\n\r\n.tableHeader \r\nThe headings of columns on things like message boards and user contributions.\r\n\r\n.verticalMenu \r\nThe vertical menu (if you use a verticall menu macro).\r\n\r\n','11,16'); -INSERT INTO help VALUES (19,'US English','Using','Macros','WebGUI macros are used to create dynamic content within otherwise static content. For instance, you may wish to show which user is logged in on every page, or you may wish to have a dynamically built menu or crumb trail. \r\n\r\nMacros always begin with a carat (^) and follow with one other character. The following is a description of all the macros in the WebGUI system.\r\n\r\n^^ - Carat\r\nSince the carat symbol is used to start all macros, this macro is in place just in case you really wanted to use a carat somewhere.\r\n\r\n^/ - System URL\r\nThe URL to the gateway script (including the domain for this site). This is often used within pages so that if your development server is on a domain different than your production server that your URLs will still worked when moved.\r\n\r\n^@ - Username\r\nThe username of the currently logged in user.\r\n\r\n^# - User ID\r\nThe user id of the currently logged in user.\r\n\r\n^* - Random Number\r\nA randomly generated number. This is often used on images (such as banner ads) that you want to ensure do not cache.\r\n\r\n^a - My Account Link\r\nA link to your account information.\r\n\r\n^C - Crumb Trail\r\nA dynamically generated crumb trail to the current page.\r\n\r\n^D - Date\r\nThe current date and time.\r\n\r\n^f - Full Menu (Vertical)\r\nDisplays a complete menu listing for all pages on the site, sort of like a site map.\r\n\r\n^F - 2 Level Menu (Vertical)\r\nDisplays the first two levels of the menuing hierarchy at all times.\r\n\r\n^h - 3 Level Menu (Vertical)\r\nDisplays the first three levels of the menuing hierarchy at all times.\r\n\r\n^H - Home Link\r\nA link to the home page of this site.\r\n\r\n^L - Login\r\nA small login form.\r\n\r\n^M - Current Menu (Vertical)\r\nA vertical menu containing the sub-pages at the current level.\r\n\r\n^m - Current Menu (Horizontal)\r\nA horizontal menu containing the sub-pages at the current level.\r\n\r\n^P - Previous Menu (Vertical)\r\nA vertical menu containing the sub-pages at the previous level.\r\n\r\n^p - Previous Menu (Horizontal)\r\nA horizontal menu containing the sub-pages at the previous level.\r\n\r\n^r - Make Page Printable\r\nCreates a link to remove the style from a page to make it printable.\r\n\r\n^T - Top Level Menu (Vertical)\r\nA vertical menu containing the main pages of the site (aka the sub-pages from the home page).\r\n\r\n^t - Top Level Menu (Horizontal)\r\nA vertical menu containing the main pages of the site (aka the sub-pages from the home page).\r\n\r\n','11,16,12'); +INSERT INTO help VALUES (19,'US English','Using','Macros','WebGUI macros are used to create dynamic content within otherwise static content. For instance, you may wish to show which user is logged in on every page, or you may wish to have a dynamically built menu or crumb trail. \r\n\r\nMacros always begin with a carat (^) and follow with one other character. The following is a description of all the macros in the WebGUI system.\r\n\r\n^^ - Carat\r\nSince the carat symbol is used to start all macros, this macro is in place just in case you really wanted to use a carat somewhere.\r\n\r\n^/ - System URL\r\nThe URL to the gateway script (including the domain for this site). This is often used within pages so that if your development server is on a domain different than your production server that your URLs will still worked when moved.\r\n\r\n^\\ - Page URL\r\nThe URL to the current page (including the domain for this site). This is often used within pages so that if your development server is on a domain different than your production server that your URLs will still worked when moved.\r\n\r\n^@ - Username\r\nThe username of the currently logged in user.\r\n\r\n^# - User ID\r\nThe user id of the currently logged in user.\r\n\r\n^* - Random Number\r\nA randomly generated number. This is often used on images (such as banner ads) that you want to ensure do not cache.\r\n\r\n^a - My Account Link\r\nA link to your account information.\r\n\r\n^C - Crumb Trail\r\nA dynamically generated crumb trail to the current page.\r\n\r\n^D - Date\r\nThe current date and time.\r\n\r\n^f - Full Menu (Vertical)\r\nDisplays a complete menu listing for all pages on the site, sort of like a site map.\r\n\r\n^F - 2 Level Menu (Vertical)\r\nDisplays the first two levels of the menuing hierarchy at all times.\r\n\r\n^h - 3 Level Menu (Vertical)\r\nDisplays the first three levels of the menuing hierarchy at all times.\r\n\r\n^H - Home Link\r\nA link to the home page of this site.\r\n\r\n^j - 2 Level, Current Level Menu (Vertical)\r\nDisplays the next two levels of the menuing hierarchy.\r\n\r\n^J - 3 Level, Current Level Menu (Vertical)\r\nDisplays the next three levels of the menuing hierarchy.\r\n\r\n^L - Login\r\nA small login form.\r\n\r\n^M - Current Menu (Vertical)\r\nA vertical menu containing the sub-pages at the current level.\r\n\r\n^m - Current Menu (Horizontal)\r\nA horizontal menu containing the sub-pages at the current level.\r\n\r\n^P - Previous Menu (Vertical)\r\nA vertical menu containing the sub-pages at the previous level.\r\n\r\n^p - Previous Menu (Horizontal)\r\nA horizontal menu containing the sub-pages at the previous level.\r\n\r\n^r - Make Page Printable\r\nCreates a link to remove the style from a page to make it printable.\r\n\r\n^T - Top Level Menu (Vertical)\r\nA vertical menu containing the main pages of the site (aka the sub-pages from the home page).\r\n\r\n^t - Top Level Menu (Horizontal)\r\nA vertical menu containing the main pages of the site (aka the sub-pages from the home page).\r\n\r\n','11,16,12'); INSERT INTO help VALUES (20,'US English','Add','SQL Report','SQL Reports are perhaps the most powerful widget in the WebGUI arsenal. They allow a user to query data from any database that they have access to. This is great for getting sales figures from your Accounting database or even summarizing all the message boards on your web site.\r\n\r\nTitle\r\nThe title of this report.\r\n\r\nDisplay Title?\r\nDo you wish to display the title of the report? If so, check the box.\r\n\r\nProcess Macros\r\nDo you wish to process WebGUI Macros on this report? If so, check the box.\r\n\r\nDescription\r\nDescribe the content of this report so your users will better understand what the report is all about.\r\n\r\nTemplate\r\nLayout a template of how this report should look. Usually you\'ll use HTML tables to generate a report. An example is included below.\r\n\r\nThere are 11 special macro characters used in generating SQL Reports. They are ^-, ^0, ^1, ^2, ^3, ^4, ^5, ^6, ^7, ^8, and ^9. These macros will be processed regardless of whether you checked the process macros box above. The ^- macro represents split points in the document where the report will begin and end looping. The numeric macros represent the data fields that will be returned from your query. Note that you may only have 10 fields returned per row in your query.\r\n\r\nSample Template:\r\n<table>\r\n<tr><th>Employee Name</th><th>Employee #</th><th>Vacation Days Remaining</th><th>Monthly Salary</th></tr>\r\n^-\r\n<tr><td>^0</td><td>^1</td><td>^2</td><td>^3</td></tr>\r\n^-\r\n</table>\r\n\r\nQuery\r\nThis is a standard SQL query. If you are unfamiliar with SQL, Plain Black Software provides training courses in SQL and database management.\r\n\r\nDSN\r\nData Source Name is the unique identifier that Perl uses to describe the location of your database. It takes the format of DBI:[driver]:[database name]:[host]. \r\n\r\nExample: DBI:mysql:WebGUI:localhost\r\n\r\nDatabase User\r\nThe username you use to connect to the DSN.\r\n\r\nDatabase Password\r\nThe password you use to connect to the DSN.\r\n\r\nConvert carriage returns?\r\nDo you wish to convert the carriage returns in the resultant data to HTML breaks (<br>).\r\n','19,14,21'); INSERT INTO help VALUES (21,'US English','Using','Widget','Widgets are the true power of WebGUI. Widgets are tiny pluggable applications built to run under WebGUI. Message boards and polls are examples of widgets.\r\n\r\nTo add a widget to a page, first go to that page, then select Add Content... from the upper left corner of your screen. Each widget has it\'s own help so be sure to read the help if you\'re not sure how to use a widget.\r\n','0'); INSERT INTO help VALUES (23,'US English','Add','Article','Articles are the Swiss Army knife of WebGUI. Most pieces of static content can be added via the Article widget.\r\n\r\nTitle\r\nWhat\'s the title for this content? Even if you don\'t wish the title to appear, it\'s a good idea to title your content so that if it is ever copied to the clipboard it will have a name.\r\n\r\nDisplay the title?\r\nDo you wish to display the title listed above?\r\n\r\nProcess macros?\r\nDo you wish to process WebGUI macros on this article? Unchecking this box will not process macros and will speed up page execution.\r\n\r\nStart Date\r\nWhat date do you want this article to appear on the site? Dates are in the format of MM/DD/YYYY. You can use the JavaScript wizard to choose your date from a calendar by clicking on the set date button. By default the date is set to 01/01/2000.\r\n\r\nEnd Date\r\nWhat date do you want this article to be removed from the site? By default the date is set to 100 years in the future, 01/01/2100.\r\n\r\nBody\r\nThe body of the article is where all the content goes. You may feel free to add HTML tags as necessary to format your content. Be sure to put a <p> between paragraphs to add white space to your content.\r\n\r\nImage\r\nChoose an image (.jpg, .gif, .png) file from your hard drive. This file will be uploaded to the server and displayed in the upper-right corner of your article.\r\n\r\nLink Title\r\nIf you wish to add a link to your article, enter the title of the link in this field. \r\n\r\nExample: Google\r\n\r\nLink URL\r\nIf you added a link title, now add the URL (uniform resource locator) here. \r\n\r\nExample: http://www.google.com\r\n\r\nAttachment\r\nIf you wish to attach a word processor file, a zip file, or any other file for download by your users, then choose it from your hard drive.\r\n','14,21'); @@ -360,6 +360,7 @@ INSERT INTO help VALUES (42,'US English','Add','Search (MnoGo)','The Title\r\nSee Add Search (MnoGo) for details.\r\n\r\nDisplay the title?\r\nSee Add Search (MnoGo) for details.\r\n\r\nDescription\r\nSee Add Search (MnoGo) for details.\r\n\r\nDSN\r\nSee Add Search (MnoGo) for details.\r\n\r\nDatabase User\r\nSee Add Search (MnoGo) for details.\r\n\r\nDatabase Password\r\nSee Add Search (MnoGo) for details.\r\n','14,21'); INSERT INTO help VALUES (44,'US English','Add','User Submission System','User submission systems are a great way to add a sense of community to any site as well as get free content from your users.\r\n\r\nTitle\r\nWhat is the title for this user submission system?\r\n\r\nDisplay the title?\r\nWould you like the title displayed?\r\n\r\nDescription\r\nBriefly describe why this user submission system is here and what should be submitted to it.\r\n\r\nWho can contribute?\r\nWhat group is allowed to contribute content?\r\n\r\nSubmissions Per Page\r\nHow many submissions should be listed per page in the submissions index?\r\n\r\nDefault Status\r\nShould submissions be set to approved, pending, or denied by default?\r\n\r\nNote: If you set the default status to pending, then be prepared to monitor the pending queue under the Admin menu.\r\n','14,21'); INSERT INTO help VALUES (45,'US English','Edit','User Submission System','Title\r\nSee Add User Submission System for details.\r\n\r\nDisplay the title?\r\nSee Add User Submission System for details.\r\n\r\nDescription\r\nSee Add User Submission System for details.\r\n\r\nWho can contribute?\r\nSee Add User Submission System for details.\r\n\r\nSubmissions Per Page\r\nSee Add User Submission System for details.\r\n\r\nDefault Status\r\nSee Add User Submission System for details.\r\n','14,21'); +INSERT INTO help VALUES (46,'US English','Empty','Trash','If you choose to empty your trash, any items contained in it will be lost forever. If you\'re unsure about a few items, it might be best to cut them to your clipboard before you empty the trash.','0'); # # Table structure for table 'incrementer' @@ -526,6 +527,7 @@ CREATE TABLE session ( # Dumping data for table 'session' # +INSERT INTO session VALUES ('3|yJFcoK2pMVyHw','2001-09-16 03:09:06','2001-09-15 19:22:26',1,'10.0.0.20'); # # Table structure for table 'settings' @@ -548,8 +550,13 @@ INSERT INTO settings VALUES ('sessionTimeout','28000'); INSERT INTO settings VALUES ('attachmentDirectoryLocal','/data/WebGUI/uploads'); INSERT INTO settings VALUES ('smtpServer','smtp.mycompany.com'); INSERT INTO settings VALUES ('companyEmail','info@mycompany.com'); +INSERT INTO settings VALUES ('ldapURL','ldap://ldap.mycompany.com:389/o=MyCompany'); INSERT INTO settings VALUES ('companyName','My Company'); INSERT INTO settings VALUES ('companyURL','http://www.mycompany.com'); +INSERT INTO settings VALUES ('ldapId','shortname'); +INSERT INTO settings VALUES ('ldapIdName','LDAP Shortname'); +INSERT INTO settings VALUES ('ldapPasswordName','LDAP Password'); +INSERT INTO settings VALUES ('authMethod','WebGUI'); # # Table structure for table 'stopword' @@ -1238,6 +1245,9 @@ CREATE TABLE user ( identifier varchar(35) default NULL, email varchar(255) default NULL, icq varchar(30) default NULL, + authMethod varchar(30) NOT NULL default 'WebGUI', + ldapURL text, + connectDN varchar(255) default NULL, PRIMARY KEY (userId) ) TYPE=MyISAM; @@ -1245,31 +1255,31 @@ CREATE TABLE user ( # Dumping data for table 'user' # -INSERT INTO user VALUES (1,'Visitor','No Login','',''); -INSERT INTO user VALUES (2,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (3,'Admin','RvlMjeFPs2aAhQdo/xt/Kg','',''); -INSERT INTO user VALUES (4,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (5,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (6,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (7,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (8,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (9,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (10,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (11,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (12,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (13,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (14,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (15,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (16,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (17,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (18,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (19,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (20,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (21,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (22,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (23,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (24,'Reserved','No Login',NULL,NULL); -INSERT INTO user VALUES (25,'Reserved','No Login',NULL,NULL); +INSERT INTO user VALUES (1,'Visitor','No Login','','','WebGUI',NULL,NULL); +INSERT INTO user VALUES (2,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (3,'Admin','RvlMjeFPs2aAhQdo/xt/Kg','','','WebGUI',NULL,NULL); +INSERT INTO user VALUES (4,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (5,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (6,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (7,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (8,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (9,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (10,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (11,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (12,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (13,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (14,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (15,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (16,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (17,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (18,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (19,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (20,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (21,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (22,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (23,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (24,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); +INSERT INTO user VALUES (25,'Reserved','No Login',NULL,NULL,'WebGUI',NULL,NULL); # # Table structure for table 'widget' diff --git a/docs/install.txt b/docs/install.txt new file mode 100644 index 000000000..395f88bb6 --- /dev/null +++ b/docs/install.txt @@ -0,0 +1,52 @@ + +################################################################## +# Quick And Dirty Install Instructions # +################################################################## + +The following is a rough overview of how to install WebGUI. For +more detailed instructions read the WebGUI installation +documentation. + + http://www.plainblack.com/index.pl/installation + +QnD INSTALL INSTRUCTIONS: + +1. Install Perl 5.6.x or greater. + +2. Install the following Perl modules: + + LWP + Tie::IxHash + DBI + XML::RSS + Mysql + Digest::MD5 + Net::LDAP + +3. Install Apache (with or without mod_perl) and set up your config. + +4. Install MySQL. + +5. Install MnoGO Search (http://www.mnogosearch.org). + +6. Extract WebGUI into your webroot. + +7. Run the following Database commands. (You should modify the + commands to match your database, username, and password.) + + mysql -e "create database WebGUI" + mysql -e "grant all privileges on WebGUI.* to webgui@localhost identified by 'password'" + mysql -e "flush privileges" + mysql -uwebgui -ppassword WebGUI < docs/create.sql + +8. Edit "etc/WebGUI.conf" to patch your DB settings and log directory. + +9. Run the following command from your WebGUI directory to determine + whether you've configured your system correctly. + + perl testEnvironment.pl + + If it returns all "OK" then you're done. The default admin account + info is "Admin" and "123qwe". + + diff --git a/docs/previousVersion.sql b/docs/previousVersion.sql index d84bf7cb0..24ac5d948 100644 --- a/docs/previousVersion.sql +++ b/docs/previousVersion.sql @@ -16,7 +16,8 @@ CREATE TABLE Article ( image varchar(255) default NULL, linkTitle varchar(255) default NULL, linkURL text, - attachment varchar(255) default NULL + attachment varchar(255) default NULL, + convertCarriageReturns int(11) NOT NULL default '0' ) TYPE=MyISAM; # @@ -454,7 +455,6 @@ CREATE TABLE page ( # INSERT INTO page VALUES (1,0,'Home',3,3,1,1,1,1,0,1,0,1,'','home'); -INSERT INTO page VALUES (5,3,'Reserved',1,1,1,1,NULL,1,0,1,0,1,NULL,'page_2.1'); INSERT INTO page VALUES (6,0,'Reserved',0,0,1,1,NULL,1,0,1,0,1,NULL,NULL); INSERT INTO page VALUES (7,0,'Reserved',0,0,1,1,NULL,1,0,1,0,1,NULL,NULL); INSERT INTO page VALUES (8,0,'Reserved',0,0,1,1,NULL,1,0,1,0,1,NULL,NULL); @@ -1186,6 +1186,7 @@ CREATE TABLE submission ( image varchar(255) default NULL, attachment varchar(255) default NULL, status varchar(30) default NULL, + convertCarriageReturns int(11) NOT NULL default '0', PRIMARY KEY (submissionId) ) TYPE=MyISAM; diff --git a/docs/upgrade-0.12.0_1.0.0.sql b/docs/upgrade-0.12.0_1.0.0.sql deleted file mode 100644 index 9707974e6..000000000 --- a/docs/upgrade-0.12.0_1.0.0.sql +++ /dev/null @@ -1,3 +0,0 @@ -alter table submission add column convertCarriageReturns int not null; -alter table Article add column convertCarriageReturns int not null; - diff --git a/docs/upgrade-1.0.1_1.1.0.sql b/docs/upgrade-1.0.1_1.1.0.sql new file mode 100644 index 000000000..75d0b6ea3 --- /dev/null +++ b/docs/upgrade-1.0.1_1.1.0.sql @@ -0,0 +1,59 @@ +delete from help; + +INSERT INTO help VALUES (1,'US English','Add','Page','Think of pages as containers for content. For instance, if you want to write a letter to the editor of your favorite magazine you\'d get out a notepad (or open a word processor) and start filling it with your thoughts. The same is true with WebGUI. Create a page, then add your content to the page.\r\n\r\nTitle\r\nThe title of the page is what your users will use to navigate through the site. Titles should be descriptive, but not very long.\r\n\r\nMeta Tags\r\nMeta tags are used by some search engines to associate key words to a particular page. There is a great site called Meta Tag Builder that will help you build meta tags if you\'ve never done it before.\r\n\r\nAdvanced Users: If you have other things (like JavaScript) you usually put in the <head> area of your pages, you may put them here as well.','0'); +INSERT INTO help VALUES (2,'US English','Edit','Page','Title\r\nSee Add Page for details.\r\n\r\nMeta Tags\r\nSee Add Page for details.\r\n\r\nStyle\r\nBy default, when you create a page, it inherits a few traits from its parent. One of those traits is style. Choose from the list of styles if you would like to change the appearance of this page. See Add Style for more details.\r\n\r\nIf you check the box next to the style pull-down menu, all of the pages below this page will take on the style you\'ve chosen for this page.\r\n\r\nPage URL\r\nWhen you create a page a url for the page is generated based on the page title. If you are unhappy with the url that was chosen, you can change it here.\r\n\r\nOwner\r\nThe owner of a page is usually the person who created the page. If you\'d like to give ownership of a page to a different content manager, then change the name here. Be careful though, once you change ownership of the page, you won\'t be able to get it back unless you are an administrator.\r\n\r\nOwner can view?\r\nCan the owner view the page or not?\r\n\r\nOwner can edit?\r\nCan the owner edit the page or not? Be careful, if you decide that the owner cannot edit the page and you do not belong to the page group, then you\'ll lose the ability to edit this page.\r\n\r\nGroup\r\nA group is assigned to every page for additional privilege control. Pick a group from the pull-down menu.\r\n\r\nGroup can view?\r\nCan members of this group view this page?\r\n\r\nGroup can edit?\r\nCan members of this group edit this page?\r\n\r\nAnybody can view?\r\nCan any visitor or member regardless of the group and owner view this page?\r\n\r\nAnybody can edit?\r\nCan any visitor or member regardless of the group and owner edit this page?\r\n\r\n','9'); +INSERT INTO help VALUES (3,'US English','Delete','Page','Deleting a page can create a big mess if you are uncertain about what you are doing. When you delete a page you are also deleting the content it contains, all sub-pages connected to this page, and all the content they contain. Be certain that you have already moved all the content you wish to keep before you delete a page.\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); +INSERT INTO help VALUES (4,'US English','Delete','Style','When you delete a style all pages using that style will be reverted to the fail safe (default) style. To ensure uninterrupted viewing, you should be sure that no pages are using a style before you delete it.\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); +INSERT INTO help VALUES (5,'US English','Add','User','See Manage Users for additional details.\r\n\r\nUsername\r\nUsername is a unique identifier for a user. Sometimes called a handle, it is also how the user will be known on the site. (Note: Administrators have unlimited power in the WebGUI system. This also means they are capable of breaking the system. If you rename or create a user, be careful not to use a username already in existance.)\r\n\r\nPassword\r\nA password is used to ensure that the user is who s/he says s/he is.\r\n\r\nAuthentication Method\r\nSee Edit Settings for details.\r\n\r\nLDAP URL\r\nSee Edit Settings for details.\r\n\r\nConnect DN\r\nThe Connect DN is the cn (or common name) of a given user in your LDAP database. It should be specified as cn=John Doe. This is, in effect, the username that will be used to authenticate this user against your LDAP server.\r\n\r\nEmail Address\r\nThe user\'s email address. This must only be specified if the user will partake in functions that require email.\r\n\r\nICQ UIN\r\nThe ICQ UIN is the \"User ID Number\" on the ICQ network. ICQ is a very popular instant messaging platform.\r\n\r\nGroups\r\nGroups displays which groups the user is in. Groups that are highlighted are groups that the user is assigned to. Those that are not highlighted are other groups that can be assigned. Note that you must hold down CTRL to select multiple groups.','0'); +INSERT INTO help VALUES (6,'US English','Edit','User','Username\r\nSee Add User for details.\r\n\r\nPassword\r\nSee Add User for details.\r\n\r\nAuthentication Method\r\nSee Edit Settings for details.\r\n\r\nLDAP URL\r\nSee Edit Settings for details.\r\n\r\nConnect DN\r\nSee Add User for details.\r\n\r\nEmail Address\r\nSee Add User for details.\r\n\r\nICQ UIN\r\nSee Add User for details.\r\n\r\nGroups\r\nSee Add User for details.\r\n\r\n','12'); +INSERT INTO help VALUES (7,'US English','Delete','User','There is no need to ever actually delete a user. If you are concerned with locking out a user, then simply change their password. If you truely wish to delete a user, then please keep in mind that there are consequences. If you delete a user any content that they added to the site via widgets (like message boards and user contributions) will remain on the site. However, if another user tries to visit the deleted user\'s profile they will get an error message. Also if the user ever is welcomed back to the site, there is no way to give him/her access to his/her old content items except by re-adding the user to the users table manually.\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); +INSERT INTO help VALUES (8,'US English','Manage','User','Users are the accounts in the system that are given rights to do certain things. There are two default users built into the system: Admin and Visitor.\r\n\r\nAdmin\r\nAdmin is exactly what you\'d expect. It is a user with unlimited rights in the WebGUI environment. If it can be done, this user has the rights to do it.\r\n\r\nVisitor\r\nVisitor is exactly the opposite of Admin. Visitor has no rights what-so-ever. By default any user who is not logged in is seen as the user Visitor.','0'); +INSERT INTO help VALUES (9,'US English','Manage','Style','Styles are used to manage the look and feel of your WebGUI pages. With WebGUI, you can have an unlimited number of styles, so your site can take on as many looks as you like. You could have some pages that look like your company\'s brochure, and some pages that look like Yahoo!®. You could even have some pages that look like pages in a book. Using style management, you have ultimate control over all your designs.\r\n\r\nThere are three styles built in to WebGUI: Fail Safe, Plain Black Software, and Yahoo!®. These styles are not meant to be edited, but rather to give you samples of what\'s possible.\r\n\r\nFail Safe\r\nWhen you delete a style that is still in use on some pages, the Fail Safe style will be applied to those pages. This style has a white background and simple navigation.\r\n\r\nPlain Black Software\r\nThis is the simple design used on the Plain Black Software site.\r\n\r\nYahoo!®\r\nThis is the design of the Yahoo!® site. (Yahoo!® has not given us permission to use their design. It is simply an example.)','0'); +INSERT INTO help VALUES (10,'US English','Manage','Group','Groups are used to subdivide privileges and responsibilities within the WebGUI system. For instance, you may be building a site for a classroom situation. In that case you might set up a different group for each class that you teach. You would then apply those groups to the pages that are designed for each class.\r\n\r\nThere are four groups built into WebGUI. They are Admins, Content Managers, Visitors, and Registered Users.\r\n\r\nAdmins\r\nAdmins are users who have unlimited privileges within WebGUI. A user should only be added to the admin group if they oversee the system. Usually only one to three people will be added to this group.\r\n\r\nContent Managers\r\nContent managers are users who have privileges to add, edit, and delete content from various areas on the site. The content managers group should not be used to control individual content areas within the site, but to determine whether a user can edit content at all. You should set up additional groups to separate content areas on the site.\r\n\r\nRegistered Users\r\nWhen users are added to the system they are put into the registered users group. A user should only be removed from this group if their account is deleted or if you wish to punish a troublemaker.\r\n\r\nVisitors\r\nVisitors are users who are not logged in using an account on the system. Also, if you wish to punish a registered user you could remove him/her from the Registered Users group and insert him/her into the Visitors group.','0'); +INSERT INTO help VALUES (11,'US English','Edit','Style','Style Name\r\nSee Add Style for details.\r\n\r\nHeader\r\nSee Add Style for details.\r\n\r\nFooter\r\nSee Add Style for details.\r\n\r\nStyle Sheet\r\nSee Add Style for details.\r\n\r\n','18,19'); +INSERT INTO help VALUES (12,'US English','Edit','Settings','Settings are items that allow you to adjust WebGUI to your particular needs.\r\n\r\nPath to WebGUI Extras\r\nThe web-path to the directory containing WebGUI images and javascript files.\r\n\r\nMaximum Attachment Size\r\nThe maximum size of files allowed to be uploaded to this site. This applies to all widgets that allow uploaded files and images (like Article and User Contributions). This size is measured in kilobytes.\r\n\r\nWeb Attachment Path\r\nThe web-path of the directory where attachments are to be stored.\r\n\r\nServer Attachment Path\r\nThe local path of the directory where attachments are to be stored. (Perhaps /var/www/public/uploads) Be sure that the web server has the rights to write to that directory.\r\n\r\nCompany Name\r\nThe name of your company. It will appear on all emails and anywhere you use the Company Name macro.\r\n\r\nCompany Email Address\r\nA general email address at your company. This is the address that all automated messages will come from. It can also be used via the WebGUI macro system.\r\n\r\nCompany URL\r\nThe primary URL of your company. This will appear on all automated emails sent from the WebGUI system. It is also available via the WebGUI macro system.\r\n\r\nAuthentication Method (default)\r\nWhat should the default authentication method be for new accounts that are created? The two available options are WebGUI and LDAP. WebGUI authentication means that the users will authenticate against the username and password stored in the WebGUI database. LDAP authentication means that users will authenticate against an external LDAP server.\r\n\r\nNote: Authentication settings can be customized on a per user basis.\r\n\r\nLDAP URL (default)\r\nThe default url to your LDAP server. The LDAP URL takes the form of ldap://[server]:[port]/[base DN]. Example: ldap://ldap.mycompany.com:389/o=MyCompany.\r\n\r\nLDAP Identity\r\nThe LDAP Identity is the unique identifier in the LDAP server that the user will be identified against. Often this field is shortname, which takes the form of first initial + last name. Example: jdoe. Therefore if you specify the LDAP identity to be shortname then Jon Doe would enter jdoe during the registration process.\r\n\r\nLDAP Identity Name\r\nThe label used to describe the LDAP Identity to the user. For instance, some companies use an LDAP server for their proxy server users to authenticate against. In the documentation or training already provided to their users, the LDAP identity is known as their Web Username. So you could enter that label here for consitency.\r\n\r\nLDAP Password Name\r\nJust as the LDAP Identity Name is a label, so is the LDAP Password Name. Use this label as you would LDAP Identity Name.\r\n\r\nSession Timeout\r\nThe time (in seconds) that a user session remains active (before needing to log in again). This timeout is reset each time a visitor hits a page. Therefore if you set the timeout for 8 hours, a user would have to log in again if s/he hadn\'t visited the site for 8 hours.\r\n\r\n1800 = half hour\r\n3600 = 1 hour\r\n28000 = 8 hours\r\n86400 = 1 day\r\n604800 = 1 week\r\n1209600 = 2 weeks\r\n\r\nSMTP Server\r\nThis is the address of your local mail server. It is needed for all features that use the Internet email system (such as password recovery).\r\n\r\n\r\n','19'); +INSERT INTO help VALUES (13,'US English','Edit','Group','Group Name\r\nSee Add Group for details.\r\n\r\nDescription\r\nSee Add Group for details.\r\n','0'); +INSERT INTO help VALUES (14,'US English','Delete','Widget','This function permanently deletes the selected widget from a page. If you are unsure whether you wish to delete this content you may be better served to cut the content to the clipboard until you are certain you wish to delete it.\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); +INSERT INTO help VALUES (15,'US English','Delete','Group','As the function suggests you\'ll be deleting a group and removing all users from the group. Be careful not to orphan users from pages they should have access to by deleting a group that is in use.\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.','0'); +INSERT INTO help VALUES (16,'US English','Add','Style','Styles are WebGUI macro enabled. See Using Macros for more information.\r\n\r\nStyle Name\r\nA unique name to describe what this style looks like at a glance. The name has no effect on the actual look of the style.\r\n\r\nHeader\r\nThe header is the start of the look of your site. It is helpful to look at your design and cut it into three pieces. The top and left of your design is the header. The center part is the content, and the right and bottom is the footer. Cut the HTML from your header and paste it in the space provided.\r\n\r\nIf you are in need of assistance for creating a look for your site, or if you need help cutting apart your design, Plain Black Software provides support services for a small fee.\r\n\r\nMany people will add WebGUI macros to their header for automated navigation, and other features.\r\n\r\nFooter\r\nThe footer is the end of the look for your site. It is the right and bottom portion of your design. You may also place WebGUI macros in your footer.\r\n\r\nStyle Sheet\r\nPlace your style sheet entries here. Style sheets are used to control colors, sizes, and other properties of the elements on your site. See Using Style Sheets for more information.\r\n\r\nAdvanced Users: for greater performance create your stylesheet on the file system (call it something like webgui.css) and add an entry like this to this area: \r\n<link href=\"/webgui.css\" rel=\"stylesheet\" rev=\"stylesheet\" type=\"text/css\">','18,19'); +INSERT INTO help VALUES (17,'US English','Add','Group','See Manage Group for a description of grouping functions and the default groups.\r\n\r\nGroup Name\r\nA name for the group. It is best if the name is descriptive so you know what it is at a glance.\r\n\r\nDescription\r\nA longer description of the group so that other admins and content managers (or you if you forget) will know what the purpose of this group is.','0'); +INSERT INTO help VALUES (22,'US English','Edit','SQL Report','Title\r\nSee Add SQL Report for details.\r\n\r\nDisplay Title?\r\nSee Add SQL Report for details.\r\n\r\nProcess Macros\r\nSee Add SQL Report for details.\r\n\r\nDescription\r\nSee Add SQL Report for details.\r\n\r\nTemplate\r\nSee Add SQL Report for details.\r\n\r\nQuery\r\nSee Add SQL Report for details.\r\n\r\nDSN\r\nSee Add SQL Report for details.\r\n\r\nDatabase User\r\nSee Add SQL Report for details.\r\n\r\nDatabase Password\r\nSee Add SQL Report for details.\r\n\r\nConvert carriage returns?\r\nSee Add SQL Report for details.\r\n\r\n','19,14,21'); +INSERT INTO help VALUES (18,'US English','Using','Style Sheets','Cascading Style Sheets (CSS) are a great way to manage the look and feel of any web site. They are used extensively in WebGUI.\r\n\r\nIf you are unfamiliar with how to use CSS, Plain Black Software provides training classes on XHTML and CSS. Alternatively, Bradsoft makes an excellent CSS editor called Top Style.\r\n\r\nThe following is a list of classes used to control the look of WebGUI:\r\n\r\nA\r\nThe links throughout the style.\r\n\r\nBODY\r\nThe default setup of all pages within a style.\r\n\r\nH1\r\nThe headers on every page.\r\n\r\n.accountOptions\r\nThe links that appear under the login and account update forms.\r\n\r\n.adminBar \r\nThe bar that appears at the top of the page when you\'re in admin mode.\r\n\r\n.boardMenu \r\nThe menu on the message boards.\r\n\r\n.boardMessage \r\nThe full message text.\r\n\r\n.boardTitle \r\nThe title of the message board.\r\n\r\n.content\r\nThe main content area on all pages of the style.\r\n\r\n.crumbTrail \r\nThe crumb trail (if you\'re using that macro).\r\n\r\n.eventTitle \r\nThe title of an individual event.\r\n\r\n.faqQuestion\r\nAn F.A.Q. question. To distinguish it from an answer.\r\n\r\n.formDescription \r\nThe tags on all forms next to the form elements. \r\n\r\n.formSubtext \r\nThe tags below some form elements.\r\n\r\n.highlight \r\nDenotes a highlighted item, such as which message you are viewing within a list.\r\n\r\n.horizontalMenu \r\nThe horizontal menu (if you use a horizontal menu macro).\r\n\r\n.loginBox\r\nThe login box macro.\r\n\r\n.pagination \r\nThe Previous and Next links on pages with pagination.\r\n\r\n.pollAnswer \r\nAn answer on a poll.\r\n\r\n.pollColor \r\nThe color of the percentage bar on a poll.\r\n\r\n.pollQuestion \r\nThe question on a poll.\r\n\r\n.tableData \r\nThe data rows on things like message boards and user contributions.\r\n\r\n.tableHeader \r\nThe headings of columns on things like message boards and user contributions.\r\n\r\n.verticalMenu \r\nThe vertical menu (if you use a verticall menu macro).\r\n\r\n','11,16'); +INSERT INTO help VALUES (19,'US English','Using','Macros','WebGUI macros are used to create dynamic content within otherwise static content. For instance, you may wish to show which user is logged in on every page, or you may wish to have a dynamically built menu or crumb trail. \r\n\r\nMacros always begin with a carat (^) and follow with one other character. The following is a description of all the macros in the WebGUI system.\r\n\r\n^^ - Carat\r\nSince the carat symbol is used to start all macros, this macro is in place just in case you really wanted to use a carat somewhere.\r\n\r\n^/ - System URL\r\nThe URL to the gateway script (including the domain for this site). This is often used within pages so that if your development server is on a domain different than your production server that your URLs will still worked when moved.\r\n\r\n^\\ - Page URL\r\nThe URL to the current page (including the domain for this site). This is often used within pages so that if your development server is on a domain different than your production server that your URLs will still worked when moved.\r\n\r\n^@ - Username\r\nThe username of the currently logged in user.\r\n\r\n^# - User ID\r\nThe user id of the currently logged in user.\r\n\r\n^* - Random Number\r\nA randomly generated number. This is often used on images (such as banner ads) that you want to ensure do not cache.\r\n\r\n^a - My Account Link\r\nA link to your account information.\r\n\r\n^C - Crumb Trail\r\nA dynamically generated crumb trail to the current page.\r\n\r\n^D - Date\r\nThe current date and time.\r\n\r\n^f - Full Menu (Vertical)\r\nDisplays a complete menu listing for all pages on the site, sort of like a site map.\r\n\r\n^F - 2 Level Menu (Vertical)\r\nDisplays the first two levels of the menuing hierarchy at all times.\r\n\r\n^h - 3 Level Menu (Vertical)\r\nDisplays the first three levels of the menuing hierarchy at all times.\r\n\r\n^H - Home Link\r\nA link to the home page of this site.\r\n\r\n^j - 2 Level, Current Level Menu (Vertical)\r\nDisplays the next two levels of the menuing hierarchy.\r\n\r\n^J - 3 Level, Current Level Menu (Vertical)\r\nDisplays the next three levels of the menuing hierarchy.\r\n\r\n^L - Login\r\nA small login form.\r\n\r\n^M - Current Menu (Vertical)\r\nA vertical menu containing the sub-pages at the current level.\r\n\r\n^m - Current Menu (Horizontal)\r\nA horizontal menu containing the sub-pages at the current level.\r\n\r\n^P - Previous Menu (Vertical)\r\nA vertical menu containing the sub-pages at the previous level.\r\n\r\n^p - Previous Menu (Horizontal)\r\nA horizontal menu containing the sub-pages at the previous level.\r\n\r\n^r - Make Page Printable\r\nCreates a link to remove the style from a page to make it printable.\r\n\r\n^T - Top Level Menu (Vertical)\r\nA vertical menu containing the main pages of the site (aka the sub-pages from the home page).\r\n\r\n^t - Top Level Menu (Horizontal)\r\nA vertical menu containing the main pages of the site (aka the sub-pages from the home page).\r\n\r\n','11,16,12'); +INSERT INTO help VALUES (20,'US English','Add','SQL Report','SQL Reports are perhaps the most powerful widget in the WebGUI arsenal. They allow a user to query data from any database that they have access to. This is great for getting sales figures from your Accounting database or even summarizing all the message boards on your web site.\r\n\r\nTitle\r\nThe title of this report.\r\n\r\nDisplay Title?\r\nDo you wish to display the title of the report? If so, check the box.\r\n\r\nProcess Macros\r\nDo you wish to process WebGUI Macros on this report? If so, check the box.\r\n\r\nDescription\r\nDescribe the content of this report so your users will better understand what the report is all about.\r\n\r\nTemplate\r\nLayout a template of how this report should look. Usually you\'ll use HTML tables to generate a report. An example is included below.\r\n\r\nThere are 11 special macro characters used in generating SQL Reports. They are ^-, ^0, ^1, ^2, ^3, ^4, ^5, ^6, ^7, ^8, and ^9. These macros will be processed regardless of whether you checked the process macros box above. The ^- macro represents split points in the document where the report will begin and end looping. The numeric macros represent the data fields that will be returned from your query. Note that you may only have 10 fields returned per row in your query.\r\n\r\nSample Template:\r\n<table>\r\n<tr><th>Employee Name</th><th>Employee #</th><th>Vacation Days Remaining</th><th>Monthly Salary</th></tr>\r\n^-\r\n<tr><td>^0</td><td>^1</td><td>^2</td><td>^3</td></tr>\r\n^-\r\n</table>\r\n\r\nQuery\r\nThis is a standard SQL query. If you are unfamiliar with SQL, Plain Black Software provides training courses in SQL and database management.\r\n\r\nDSN\r\nData Source Name is the unique identifier that Perl uses to describe the location of your database. It takes the format of DBI:[driver]:[database name]:[host]. \r\n\r\nExample: DBI:mysql:WebGUI:localhost\r\n\r\nDatabase User\r\nThe username you use to connect to the DSN.\r\n\r\nDatabase Password\r\nThe password you use to connect to the DSN.\r\n\r\nConvert carriage returns?\r\nDo you wish to convert the carriage returns in the resultant data to HTML breaks (<br>).\r\n','19,14,21'); +INSERT INTO help VALUES (21,'US English','Using','Widget','Widgets are the true power of WebGUI. Widgets are tiny pluggable applications built to run under WebGUI. Message boards and polls are examples of widgets.\r\n\r\nTo add a widget to a page, first go to that page, then select Add Content... from the upper left corner of your screen. Each widget has it\'s own help so be sure to read the help if you\'re not sure how to use a widget.\r\n','0'); +INSERT INTO help VALUES (23,'US English','Add','Article','Articles are the Swiss Army knife of WebGUI. Most pieces of static content can be added via the Article widget.\r\n\r\nTitle\r\nWhat\'s the title for this content? Even if you don\'t wish the title to appear, it\'s a good idea to title your content so that if it is ever copied to the clipboard it will have a name.\r\n\r\nDisplay the title?\r\nDo you wish to display the title listed above?\r\n\r\nProcess macros?\r\nDo you wish to process WebGUI macros on this article? Unchecking this box will not process macros and will speed up page execution.\r\n\r\nStart Date\r\nWhat date do you want this article to appear on the site? Dates are in the format of MM/DD/YYYY. You can use the JavaScript wizard to choose your date from a calendar by clicking on the set date button. By default the date is set to 01/01/2000.\r\n\r\nEnd Date\r\nWhat date do you want this article to be removed from the site? By default the date is set to 100 years in the future, 01/01/2100.\r\n\r\nBody\r\nThe body of the article is where all the content goes. You may feel free to add HTML tags as necessary to format your content. Be sure to put a <p> between paragraphs to add white space to your content.\r\n\r\nImage\r\nChoose an image (.jpg, .gif, .png) file from your hard drive. This file will be uploaded to the server and displayed in the upper-right corner of your article.\r\n\r\nLink Title\r\nIf you wish to add a link to your article, enter the title of the link in this field. \r\n\r\nExample: Google\r\n\r\nLink URL\r\nIf you added a link title, now add the URL (uniform resource locator) here. \r\n\r\nExample: http://www.google.com\r\n\r\nAttachment\r\nIf you wish to attach a word processor file, a zip file, or any other file for download by your users, then choose it from your hard drive.\r\n','14,21'); +INSERT INTO help VALUES (24,'US English','Edit','Article','Title\r\nSee Add Article for details.\r\n\r\nDisplay the title?\r\nSee Add Article for details.\r\n\r\nProcess macros?\r\nSee Add Article for details.\r\n\r\nStart Date\r\nSee Add Article for details.\r\n\r\nEnd Date\r\nSee Add Article for details.\r\n\r\nBody\r\nSee Add Article for details.\r\n\r\nImage\r\nSee Add Article for details.\r\n\r\nLink Title\r\nSee Add Article for details.\r\n\r\nLink URL\r\nSee Add Article for details.\r\n\r\nAttachment\r\nSee Add Article for details.\r\n','14,21'); +INSERT INTO help VALUES (25,'US English','Add','Extra Column','Extra columns allow you to change the layout of your page for one page only. If you wish to have multiple columns on all your pages. Perhaps you should consider altering the style applied to your pages. \r\n\r\nColumns are always added from left to right. Therefore any existing content will be on the left of the new column.\r\n\r\nSpacer\r\nSpacer is the amount of space between your existing content and your new column. It is measured in pixels.\r\n\r\nWidth\r\nWidth is the actual width of the new column to be added. Width is measured in pixels.\r\n\r\nStyleSheet Class\r\nBy default the content style (which is the style the body of your site should be using) that is applied to all columns. However, if you\'ve created a style specifically for columns, then feel free to modify this class.\r\n','14,21,9,18'); +INSERT INTO help VALUES (26,'US English','Edit','Extra Column','Spacer\r\nSee Add Extra Column for details.\r\n\r\nWidth\r\nSee Add Extra Column for details.\r\n\r\nStyleSheet Class\r\nSee Add Extra Column for details.\r\n','14,21,9,18'); +INSERT INTO help VALUES (27,'US English','Add','Widget','You can add widgets by selecting from the Add Content pulldown menu.','0'); +INSERT INTO help VALUES (28,'US English','Add','Poll','Polls can be used to get the impressions of your users on various topics.\r\n\r\nTitle\r\nThe title of the poll. Even if you don\'t wish to display the title you should fill out this field so this poll will have a name if it is ever placed in the clipboard.\r\n\r\nDisplay the title?\r\nDo you wish to disply the title?\r\n\r\nDescription\r\nYou may provide a description for this poll, or give the user some background information.\r\n\r\nActive\r\nIf this box is checked, then users will be able to vote. Otherwise they\'ll only be able to see the results of the poll.\r\n\r\nWho can vote?\r\nChoose a group that can vote on this poll.\r\n\r\nGraph Width\r\nThe width of the poll results graph. The width is measured in pixels.\r\n\r\nQuestion\r\nWhat is the question you\'d like to ask your users?\r\n\r\nAnswers\r\nEnter the possible answers to your question. Enter only one answer per line. Polls are only capable of 20 possible answers.\r\n','14,21,19'); +INSERT INTO help VALUES (29,'US English','Edit','Poll','Title\r\nSee Add Poll for details.\r\n\r\nDisplay the title?\r\nSee Add Poll for details.\r\n\r\nDescription\r\nSee Add Poll for details.\r\n\r\nActive\r\nSee Add Poll for details.\r\n\r\nWho can vote?\r\nSee Add Poll for details.\r\n\r\nGraph Width\r\nSee Add Poll for details.\r\n\r\nQuestion\r\nSee Add Poll for details.\r\n\r\nAnswers\r\nSee Add Poll for details.\r\n','14,21,19'); +INSERT INTO help VALUES (30,'US English','Add','Site Map','Site maps are used to provide additional navigation in WebGUI. You could set up a traditional site map that would display a hierarchical view of all the pages in the site. On the other hand, you could use site maps to provide extra navigation at certain levels in your site.\r\n\r\nTitle\r\nWhat title would you give to this site map? You should fill this field out even if you don\'t wish it to be displayed.\r\n\r\nDisplay Title\r\nShould the title be displayed?\r\n\r\nDescription\r\nEnter a description as to why this site map is here and what purpose it serves.\r\n\r\nStarting from this level?\r\nIf the site map should display the page tree starting from this level, then check this box. If you wish the site map to start from the home page then uncheck it.\r\n\r\nShow only one level?\r\nShould the site map display only the current level of pages or all pages from this point forward? \r\n','14,21,19'); +INSERT INTO help VALUES (31,'US English','Edit','Site Map','Title\r\nSee Add Site Map for details.\r\n\r\nDisplay Title\r\nSee Add Site Map for details.\r\n\r\nDescription\r\nSee Add Site Map for details.\r\n\r\nStarting from this level?\r\nSee Add Site Map for details.\r\n\r\nShow only one level?\r\nSee Add Site Map for details.\r\n','14,21,19'); +INSERT INTO help VALUES (32,'US English','Add','Message Board','Message boards, also called Forums and/or Discussions, are a great way to add community to any site or intranets. Many companies use message boards internally to collaborate on projects.\r\n\r\nTitle\r\nThe name of this board.\r\n\r\nDisplay the title?\r\nDo you wish to display the title?\r\n\r\nDescription\r\nBriefly describe what should be displayed on this message board.\r\n\r\nWho can post?\r\nWhat group can post to this message board?\r\n\r\nMessages Per Page\r\nWhen a visitor first comes to a message board s/he will be presented with a listing of all the topics (aka threads) of the message board. If a board is popular, it will quickly have many topics. The messages per page attribute allows you to specify how many topics should be shown on one page.\r\n\r\nEdit Timeout\r\nHow long after a user has posted to the board will their message be available for them to edit. This timeout is measured in hours.\r\n\r\nNote: Don\'t set this limit too high. One of the great things about message boards is that they are an accurate record of a discussion. If you allow editing for a long time, then a user has a chance to go back and change his/her mind a long time after the original statement was made.\r\n','14,21,19'); +INSERT INTO help VALUES (33,'US English','Edit','Message Board','Title\r\nSee Add Message Board for details.\r\n\r\nDisplay the title?\r\nSee Add Message Board for details.\r\n\r\nDescription\r\nSee Add Message Board for details.\r\n\r\nWho can post?\r\nSee Add Message Board for details.\r\n\r\nMessages Per Page\r\nSee Add Message Board for details.\r\n\r\nEdit Timeout\r\nSee Add Message Board for details.\r\n','14,21,19'); +INSERT INTO help VALUES (34,'US English','Add','Link List','Link lists are just what they sound like, a list of links. Many sites have a links section, and this just automates the process.\r\n\r\nTitle\r\nWhat is the title of this link list?\r\n\r\nDisplay the title?\r\nDo you wish to display the title of this list?\r\n\r\nProcess macros?\r\nDo you wish to process macros on the contents of this link list? Turning this off will increase performance slightly on busy sites.\r\n\r\nDescription\r\nDescribe the purpose of the links in this list.','14,21,19'); +INSERT INTO help VALUES (35,'US English','Edit','Link List','Title\r\nSee Add Link List for details.\r\n\r\nDisplay the title?\r\nSee Add Link List for details.\r\n\r\nProcess macros?\r\nSee Add Link List for details.\r\n\r\nDescription\r\nSee Add Link List for details.\r\n\r\nAdding / Editing Links\r\nYou\'ll notice at the bottom of the Edit screen that there are some options to add, edit, delete and reorder the links in your link lists. This process works exactly as the process for doing the same with widgets and pages. The three properties of links are name, url, and description.\r\n','14,21,19'); +INSERT INTO help VALUES (36,'US English','Add','Syndicated Content','Syndicated content is content that is pulled from another site using the RDF/RSS specification. This technology is often used to pull headlines from various news sites like CNN and Slashdot. It can, of course, be used for other things like sports scores, stock market info, etc.\r\n\r\nYou can find a list of syndicated content at http://my.userland.com. You will need to register with an account to browse their listing of content. Also, the list contained there is by no means a complete list of all the syndicated content on the internet.\r\n\r\nTitle\r\nWhat is the title for this content? This is often the title of the site that the content comes from.\r\n\r\nDisplay the title?\r\nDo you wish to display the title?\r\n\r\nDescription\r\nBriefly describe the content being pulled so that your users will know what they are seeing.\r\n\r\nURL to RSS file\r\nProvide the exact URL (starting with http://) to the syndicated content\'s RDF or RSS file. The syndicated content will be downloaded from this URL hourly.','14,21'); +INSERT INTO help VALUES (37,'US English','Edit','Syndicated Content','Title\r\nSee Add Syndicated Content for details.\r\n\r\nDisplay the title?\r\nSee Add Syndicated Content for details.\r\n\r\nDescription\r\nSee Add Syndicated Content for details.\r\n\r\nURL to RSS file\r\nSee Add Syndicated Content for details.\r\n','14,21'); +INSERT INTO help VALUES (38,'US English','Add','Events Calendar','Events calendars are used on many intranets to keep track of internal dates that affect a whole organization. Also events calendars on consumer sites are a great way to let your customers know what events you\'ll be attending and what promotions you\'ll be having.\r\n\r\nTitle\r\nWhat is the title of this events calendar?\r\n\r\nDisplay the title?\r\nDo you want the title to be displayed?\r\n\r\nProcess macros?\r\nDo you wish to process WebGUI macros in the content of the events calendar? Turning this off can increase performance on busy sites.\r\n\r\nDescription\r\nBriefly describe what this events calendar details.\r\n','14,21,19'); +INSERT INTO help VALUES (39,'US English','Edit','Events Calendar','Title\r\nSee Add Events Calendar for details.\r\n\r\nDisplay the title?\r\nSee Add Events Calendar for details.\r\n\r\nProcess macros?\r\nSee Add Events Calendar for details.\r\n\r\nDescription\r\nSee Add Events Calendar for details.\r\n\r\nAdd / Edit Events\r\nOn the edit screen you\'ll notice that there are options to add, edit, and delete the events in your events calendar. The properties for events are name, description, start date, and end date.\r\n\r\nNote: Events that have already happened will not be displayed on the events calendar.','14,21,19'); +INSERT INTO help VALUES (40,'US English','Add','F.A.Q.','It seems that almost every web site, intranet, and extranet in the world has a frequently asked questions area. This widget helps you build one too.\r\n\r\nTitle\r\nWhat is the title for this FAQ section?\r\n\r\nDisplay the title?\r\nDo you wish to display the title?\r\n\r\nProcess macros?\r\nDo you wish to process macros contained in the FAQ content? Turning this off will increase performance on busy sites.\r\n\r\nDescription\r\nBriefly describe what this FAQ covers.\r\n','14,21,19'); +INSERT INTO help VALUES (41,'US English','Edit','F.A.Q.','Title\r\nSee Add F.A.Q. for details.\r\n\r\nDisplay the title?\r\nSee Add F.A.Q. for details.\r\n\r\nProcess macros?\r\nSee Add F.A.Q. for details.\r\n\r\nDescription\r\nSee Add F.A.Q. for details.\r\n\r\nAdd / Edit Questions\r\nOn the edit screen you\'ll notice options for adding, editing, deleting, and reordering the questions in your FAQ. The two properties of FAQ questions are question and answer.\r\n\r\n','14,21,19'); +INSERT INTO help VALUES (42,'US English','Add','Search (MnoGo)','The Mno Go Search engine is one of the most popular and powerful open-source search engines on the market. It is so good that we figured that there was no reason to reinvent the wheel so we incorperated it into WebGUI.\r\n\r\nTitle\r\nWhat is the title of this search?\r\n\r\nDisplay the title?\r\nDo you want to display the title?\r\n\r\nDescription\r\nBriefly describe what is available through this search engine.\r\n\r\nDSN\r\nData Source Name is the unique identifier that Perl uses to describe the location of your database. It takes the format of DBI:[driver]:[database name]:[host]. This DSN needs to point to where your Mno Go Indexer stored the spider results. If you are uncertain how to set up the Mno Go Search Engine and Indexer Plain Black Software provides support and training services.\r\n\r\nExample: DBI:mysql:WebGUI:localhost\r\n\r\nDatabase User\r\nThe username you use to connect to the DSN.\r\n\r\nDatabase Password\r\nThe password you use to connect to the DSN.\r\n','14,21'); +INSERT INTO help VALUES (43,'US English','Edit','Search (MnoGo)','Title\r\nSee Add Search (MnoGo) for details.\r\n\r\nDisplay the title?\r\nSee Add Search (MnoGo) for details.\r\n\r\nDescription\r\nSee Add Search (MnoGo) for details.\r\n\r\nDSN\r\nSee Add Search (MnoGo) for details.\r\n\r\nDatabase User\r\nSee Add Search (MnoGo) for details.\r\n\r\nDatabase Password\r\nSee Add Search (MnoGo) for details.\r\n','14,21'); +INSERT INTO help VALUES (44,'US English','Add','User Submission System','User submission systems are a great way to add a sense of community to any site as well as get free content from your users.\r\n\r\nTitle\r\nWhat is the title for this user submission system?\r\n\r\nDisplay the title?\r\nWould you like the title displayed?\r\n\r\nDescription\r\nBriefly describe why this user submission system is here and what should be submitted to it.\r\n\r\nWho can contribute?\r\nWhat group is allowed to contribute content?\r\n\r\nSubmissions Per Page\r\nHow many submissions should be listed per page in the submissions index?\r\n\r\nDefault Status\r\nShould submissions be set to approved, pending, or denied by default?\r\n\r\nNote: If you set the default status to pending, then be prepared to monitor the pending queue under the Admin menu.\r\n','14,21'); +INSERT INTO help VALUES (45,'US English','Edit','User Submission System','Title\r\nSee Add User Submission System for details.\r\n\r\nDisplay the title?\r\nSee Add User Submission System for details.\r\n\r\nDescription\r\nSee Add User Submission System for details.\r\n\r\nWho can contribute?\r\nSee Add User Submission System for details.\r\n\r\nSubmissions Per Page\r\nSee Add User Submission System for details.\r\n\r\nDefault Status\r\nSee Add User Submission System for details.\r\n','14,21'); +INSERT INTO help VALUES (46,'US English','Empty','Trash','If you choose to empty your trash, any items contained in it will be lost forever. If you\'re unsure about a few items, it might be best to cut them to your clipboard before you empty the trash.','0'); + +INSERT INTO settings VALUES ('ldapURL','ldap://ldap.mycompany.com:389/o=MyCompany'); +INSERT INTO settings VALUES ('ldapId','shortname'); +INSERT INTO settings VALUES ('ldapIdName','LDAP Shortname'); +INSERT INTO settings VALUES ('ldapPasswordName','LDAP Password'); +INSERT INTO settings VALUES ('authMethod','WebGUI'); + +alter table user add column authMethod varchar(30) NOT NULL default 'WebGUI'; +alter table user add column ldapURL text; +alter table user add column connectDN varchar(255) default NULL; + diff --git a/extras/WebGUI.js b/extras/WebGUI.js index 45498861a..b22ffc1c9 100644 --- a/extras/WebGUI.js +++ b/extras/WebGUI.js @@ -41,8 +41,8 @@ function getShowMeText() { return formObj.value; } -function image(obj) { - obj.value = obj.value+''; +function imageAdd(obj) { + obj.value = obj.value+''; } function italicText(obj) { diff --git a/lib/WebGUI.pm b/lib/WebGUI.pm index 84801d838..e492060fe 100644 --- a/lib/WebGUI.pm +++ b/lib/WebGUI.pm @@ -1,5 +1,5 @@ package WebGUI; -our $VERSION = "1.0.1"; +our $VERSION = "1.1.0"; #------------------------------------------------------------------- # WebGUI is Copyright 2001 Plain Black Software. diff --git a/lib/WebGUI/Form.pm b/lib/WebGUI/Form.pm index 0e07f9fae..e88da3a09 100644 --- a/lib/WebGUI/Form.pm +++ b/lib/WebGUI/Form.pm @@ -143,7 +143,7 @@ sub textArea { $rows = 5; } if ($htmlEdit > 0) { - $output = '
'; + $output = '
'; } if ($wrap eq "") { $wrap = "virtual"; diff --git a/lib/WebGUI/Macro.pm b/lib/WebGUI/Macro.pm index d000ed259..beeebe3bf 100644 --- a/lib/WebGUI/Macro.pm +++ b/lib/WebGUI/Macro.pm @@ -60,10 +60,14 @@ sub process { if ($output =~ /\^\^/) { $output =~ s/\^\^/\^/g; } - #---page url--- + #---script url--- if ($output =~ /\^\//) { $output =~ s/\^\//$session{env}{SCRIPT_NAME}/g; } + #---page url--- + if ($output =~ /\^\\/) { + $output =~ s/\^\\/$session{page}{url}/g; + } #---username--- if ($output =~ /\^\@/) { $output =~ s/\^\@/$session{user}{username}/g; @@ -126,6 +130,20 @@ sub process { $temp = 'Home'; $output =~ s/\^H/$temp/g; } + #---2 level current level menu (vertical)--- + if ($output =~ /\^j/) { + $temp = ''; + $temp .= _traversePageTree($session{page}{pageId},0,2); + $temp .= ''; + $output =~ s/\^j/$temp/g; + } + #---3 level current level menu (vertical)--- + if ($output =~ /\^J/) { + $temp = ''; + $temp .= _traversePageTree($session{page}{pageId},0,3); + $temp .= ''; + $output =~ s/\^J/$temp/g; + } #---login box--- if ($output =~ /\^L/) { $temp = '
'; diff --git a/lib/WebGUI/Operation/Account.pm b/lib/WebGUI/Operation/Account.pm index e8799a717..35c4aeeff 100644 --- a/lib/WebGUI/Operation/Account.pm +++ b/lib/WebGUI/Operation/Account.pm @@ -12,7 +12,9 @@ package WebGUI::Operation::Account; use Digest::MD5 qw(md5_base64); use Exporter; +use Net::LDAP; use strict; +use URI; use WebGUI::Form; use WebGUI::Privilege; use WebGUI::Session; @@ -21,6 +23,7 @@ use WebGUI::Utility; our @ISA = qw(Exporter); our @EXPORT = qw(&www_createAccount &www_deactivateAccount &www_deactivateAccountConfirm &www_displayAccount &www_displayLogin &www_login &www_logout &www_recoverPassword &www_recoverPasswordFinish &www_saveAccount &www_updateAccount); +our %ldapStatusCode = ( 0=>'success (0)', 1=>'Operations Error (1)', 2=>'Protocol Error (2)', 3=>'Time Limit Exceeded (3)', 4=>'Size Limit Exceeded (4)', 5=>'Compare False (5)', 6=>'Compare True (6)', 7=>'Auth Method Not Supported (7)', 8=>'Strong Auth Required (8)', 9=>'Referral (10)', 11=>'Admin Limit Exceeded (11)', 12=>'Unavailable Critical Extension (12)', 13=>'Confidentiality Required (13)', 14=>'Sasl Bind In Progress (14)', 15=>'No Such Attribute (16)', 17=>'Undefined Attribute Type (17)', 18=>'Inappropriate Matching (18)', 19=>'Constraint Violation (19)', 20=>'Attribute Or Value Exists (20)', 21=>'Invalid Attribute Syntax (21)', 32=>'No Such Object (32)', 33=>'Alias Problem (33)', 34=>'Invalid DN Syntax (34)', 36=>'Alias Dereferencing Problem (36)', 48=>'Inappropriate Authentication (48)', 49=>'Invalid Credentials (49)', 50=>'Insufficient Access Rights (50)', 51=>'Busy (51)', 52=>'Unavailable (52)', 53=>'Unwilling To Perform (53)', 54=>'Loop Detect (54)', 64=>'Naming Violation (64)', 65=>'Object Class Violation (65)', 66=>'Not Allowed On Non Leaf (66)', 67=>'Not Allowed On RDN (67)', 68=>'Entry Already Exists (68)', 69=>'Object Class Mods Prohibited (69)', 71=>'Affects Multiple DSAs (71)', 80=>'other (80)'); #------------------------------------------------------------------- sub _hasBadPassword { @@ -35,7 +38,7 @@ sub _hasBadPassword { sub _hasBadUsername { my ($otherUser); ($otherUser) = WebGUI::SQL->quickArray("select username from user where lcase(username)=lcase('$_[0]')",$session{dbh}); - if ($otherUser ne "" || $_[0] eq "") { + if (($otherUser ne "" && $otherUser ne $session{user}{username}) || $_[0] eq "") { return 1; } else { return 0; @@ -65,8 +68,15 @@ sub www_createAccount { $output .= WebGUI::Form::hidden("op","saveAccount"); $output .= ''; $output .= ''; - $output .= ''; - $output .= ''; + if ($session{setting}{authMethod} eq "LDAP") { + $output .= WebGUI::Form::hidden("identifier1","ldap-password"); + $output .= WebGUI::Form::hidden("identifier2","ldap-password"); + $output .= ''; + $output .= ''; + } else { + $output .= ''; + $output .= ''; + } $output .= ''; $output .= ''; $output .= ''; @@ -110,8 +120,12 @@ sub www_displayAccount { $output .= WebGUI::Form::hidden("op","updateAccount"); $output .= '
Username'.WebGUI::Form::text("username",20,30).'
Password'.WebGUI::Form::password("identifier1",20,30).'
Password (confirm)'.WebGUI::Form::password("identifier2",20,30).'
'.$session{setting}{ldapIdName}.''.WebGUI::Form::text("ldapId",20,100).'
'.$session{setting}{ldapPasswordName}.''.WebGUI::Form::password("ldapPassword",20,100).'
Password'.WebGUI::Form::password("identifier1",20,30).'
Password (confirm)'.WebGUI::Form::password("identifier2",20,30).'
Email Address'.WebGUI::Form::text("email",20,255).'
This is only necessary if you wish to use features that require Email.
ICQ UIN'.WebGUI::Form::text("icq",20,30).'
This is only necessary if you wish to use features that require ICQ.
'.WebGUI::Form::submit("create").'
'; $output .= ''; - $output .= ''; - $output .= ''; + if ($session{user}{authMethod} eq "LDAP") { + $output .= WebGUI::Form::hidden("identifier","password"); + } else { + $output .= ''; + $output .= ''; + } $output .= ''; $output .= ''; $output .= ''; @@ -154,13 +168,39 @@ sub www_displayLogin { #------------------------------------------------------------------- sub www_login { - my ($uid,$pass); - ($uid,$pass) = WebGUI::SQL->quickArray("select userId,identifier from user where username=".quote($session{form}{username}),$session{dbh}); - if (Digest::MD5::md5_base64($session{form}{identifier}) eq $pass && $session{form}{identifier} ne "") { + my ($uri, $port, $ldap, %args, $auth, $error, $uid,$pass,$authMethod, $ldapURL, $connectDN, $success); + ($uid,$pass,$authMethod, $ldapURL, $connectDN) = WebGUI::SQL->quickArray("select userId,identifier,authMethod,ldapURL,connectDN from user where username=".quote($session{form}{username}),$session{dbh}); + if ($authMethod eq "LDAP") { + $uri = URI->new($ldapURL); + if ($uri->port < 1) { + $port = 389; + } else { + $port = $uri->port; + } + %args = (port => $port); + $ldap = Net::LDAP->new($uri->host, %args) or $error = "Cannot connect to LDAP server."; + $auth = $ldap->bind($connectDN, $session{form}{identifier}); + $ldap->unbind; + if ($auth->code == 48 || $auth->code == 49) { + $error = "The account information you supplied is invalid. Either the account does not exist or the username/password combination was incorrect."; + } elsif ($auth->code > 0) { + $error .= 'LDAP error "'.$ldapStatusCode{$auth->code}.'" occured. Please contact your system administrator for assistance. '; + } else { + $success = 1; + } + } else { + if (Digest::MD5::md5_base64($session{form}{identifier}) eq $pass && $session{form}{identifier} ne "") { + $success = 1; + } else { + $error = "The account information you supplied is invalid. Either the account does not exist or the username/password combination was incorrect."; + } + } + if ($success) { _login($uid,$pass); return ""; } else { - return "

Invalid Account

The account information you supplied is invalid. Either the account does not exist or the username/password combination was incorrect.".www_displayLogin(); + WebGUI::ErrorHandler::warn($error); + return "

Error

".$error.www_displayLogin(); } } @@ -216,24 +256,46 @@ sub www_recoverPasswordFinish { #------------------------------------------------------------------- sub www_saveAccount { - my ($output, $error, $uid, $encryptedPassword); + my ($uri, $ldap, $port, %args, $search, $connectDN, $auth, $output, $error, $uid, $encryptedPassword); if (_hasBadUsername($session{form}{username})) { - $error = 'Error: The account name '.$session{form}{username}.' is in use by another member of this site. Please try a different username, perhaps "'.$session{form}{username}.'too" or "'.$session{form}{username}.'01"

'; + $error = 'The account name "'.$session{form}{username}.'" is in use by another member of this site. Please try a different username, perhaps "'.$session{form}{username}.'too" or "'.$session{form}{username}.'01" '; } if (_hasBadPassword($session{form}{identifier1},$session{form}{identifier2})) { - $error .= 'Error: Your passwords did not match. Please try again.

'; + $error .= 'Your passwords did not match. Please try again. '; + } + if ($session{setting}{authMethod} eq "LDAP") { + $uri = URI->new($session{setting}{ldapURL}); + if ($uri->port < 1) { + $port = 389; + } else { + $port = $uri->port; + } + %args = (port => $port); + $ldap = Net::LDAP->new($uri->host, %args) or $error .= "Cannot connect to LDAP server. "; + $ldap->bind; + $search = $ldap->search (base => $uri->dn, filter => $session{setting}{ldapId}."=".$session{form}{ldapId}); + $connectDN = "cn=".$search->entry(0)->get_value("cn"); + $ldap->unbind; + $ldap = Net::LDAP->new($uri->host, %args) or $error .= "Cannot connect to LDAP server. "; + $auth = $ldap->bind(dn=>$connectDN, password=>$session{form}{ldapPassword}); + if ($auth->code == 48 || $auth->code == 49) { + $error .= "Either your ".$session{setting}{ldapIdName}." or ".$session{setting}{ldapPasswordName}." were invalid. "; + } elsif ($auth->code > 0) { + $error .= 'LDAP error "'.$ldapStatusCode{$auth->code}.'" occured. Please contact your system administrator for assistance. '; + } + $ldap->unbind; } if ($error eq "") { $encryptedPassword = Digest::MD5::md5_base64($session{form}{identifier1}); $uid = getNextId("userId"); - WebGUI::SQL->write("insert into user set userId=$uid, username=".quote($session{form}{username}).", identifier=".quote($encryptedPassword).", email=".quote($session{form}{email}).", icq=".quote($session{form}{icq}),$session{dbh}); + WebGUI::SQL->write("insert into user set userId=$uid, username=".quote($session{form}{username}).", identifier=".quote($encryptedPassword).", authMethod=".quote($session{setting}{authMethod}).", ldapURL=".quote($session{setting}{ldapURL}).", connectDN=".quote($connectDN).", email=".quote($session{form}{email}).", icq=".quote($session{form}{icq}),$session{dbh}); WebGUI::SQL->write("insert into groupings set groupId=2,userId=$uid",$session{dbh}); _login($uid,$encryptedPassword); $output .= 'Account created successfully!

'; $output .= www_displayAccount(); } else { - $output = $error; - $output = www_createAccount(); + WebGUI::ErrorHandler::warn($error); + $output = "

Error

".$error.www_createAccount(); } return $output; } @@ -261,7 +323,7 @@ sub www_updateAccount { $output .= www_displayAccount(); } else { $output = $error; - $output = www_createAccount(); + $output .= www_createAccount(); } } else { $output .= www_displayLogin(); diff --git a/lib/WebGUI/Operation/Settings.pm b/lib/WebGUI/Operation/Settings.pm index 9f81a46e9..b2ac9e7f7 100644 --- a/lib/WebGUI/Operation/Settings.pm +++ b/lib/WebGUI/Operation/Settings.pm @@ -23,20 +23,31 @@ our @EXPORT = qw(&www_editSettings &www_editSettingsSave); #------------------------------------------------------------------- sub www_editSettings { - my ($output); + my ($output, %authMethod, @array); + %authMethod = ('WebGUI'=>'WebGUI', 'LDAP'=>'LDAP'); if (WebGUI::Privilege::isInGroup(3)) { $output .= '

Edit Settings

'; $output .= WebGUI::Form::hidden("op","editSettingsSave"); $output .= '
username'.WebGUI::Form::text("username",20,30,$session{user}{username}).'
password'.WebGUI::Form::password("identifier1",20,30,"password").'
password (confirm)'.WebGUI::Form::password("identifier2",20,30,"password").'
password'.WebGUI::Form::password("identifier1",20,30,"password").'
password (confirm)'.WebGUI::Form::password("identifier2",20,30,"password").'
email address'.WebGUI::Form::text("email",20,255,$session{user}{email}).'
This is only necessary if you wish to use features that require Email.
ICQ UIN'.WebGUI::Form::text("icq",20,30,$session{user}{icq}).'
This is only necessary if you wish to use features that require ICQ.
'.WebGUI::Form::submit("update").'
'; - $output .= ''; - $output .= ''; - $output .= ''; - $output .= ''; - $output .= ''; - $output .= ''; - $output .= ''; - $output .= ''; - $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $array[0] = $session{setting}{authMethod}; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; $output .= ''; $output .= '
Path to WebGUI Extras'.WebGUI::Form::text("lib",20,255,$session{setting}{lib}).'
Session Timeout'.WebGUI::Form::text("sessionTimeout",20,11,$session{setting}{sessionTimeout}).'
Maximum Attachment Size'.WebGUI::Form::text("maxAttachmentSize",20,11,$session{setting}{maxAttachmentSize}).'
Web Attachment Path'.WebGUI::Form::text("attachmentDirectoryWeb",20,255,$session{setting}{attachmentDirectoryWeb}).'
Server Attachment Path'.WebGUI::Form::text("attachmentDirectoryLocal",20,255,$session{setting}{attachmentDirectoryLocal}).'
SMTP Server'.WebGUI::Form::text("smtpServer",20,255,$session{setting}{smtpServer}).'
Company Name'.WebGUI::Form::text("companyName",20,255,$session{setting}{companyName}).'
Company Email Address'.WebGUI::Form::text("companyEmail",20,255,$session{setting}{companyEmail}).'
Company URL'.WebGUI::Form::text("companyURL",20,255,$session{setting}{companyURL}).'
Files
Path to WebGUI Extras'.WebGUI::Form::text("lib",30,255,$session{setting}{lib}).'
Maximum Attachment Size'.WebGUI::Form::text("maxAttachmentSize",30,11,$session{setting}{maxAttachmentSize}).'
Web Attachment Path'.WebGUI::Form::text("attachmentDirectoryWeb",30,255,$session{setting}{attachmentDirectoryWeb}).'
Server Attachment Path'.WebGUI::Form::text("attachmentDirectoryLocal",30,255,$session{setting}{attachmentDirectoryLocal}).'
Company Information
Company Name'.WebGUI::Form::text("companyName",30,255,$session{setting}{companyName}).'
Company Email Address'.WebGUI::Form::text("companyEmail",30,255,$session{setting}{companyEmail}).'
Company URL'.WebGUI::Form::text("companyURL",30,2048,$session{setting}{companyURL}).'
Authentication
Authentication Method (default)'.WebGUI::Form::selectList("authMethod",\%authMethod, \@array).'
LDAP URL (default)'.WebGUI::Form::text("ldapURL",30,2048,$session{setting}{ldapURL}).'
LDAP Identity (default)'.WebGUI::Form::text("ldapId",30,100,$session{setting}{ldapId}).'
LDAP Identity Name'.WebGUI::Form::text("ldapIdName",30,100,$session{setting}{ldapIdName}).'
LDAP Password Name'.WebGUI::Form::text("ldapPasswordName",30,100,$session{setting}{ldapPasswordName}).'
Miscellaneous
Session Timeout'.WebGUI::Form::text("sessionTimeout",30,11,$session{setting}{sessionTimeout}).'
SMTP Server'.WebGUI::Form::text("smtpServer",30,255,$session{setting}{smtpServer}).'
'.WebGUI::Form::submit("save").'
'; $output .= ' '; @@ -59,6 +70,11 @@ sub www_editSettingsSave { WebGUI::SQL->write("update settings set value=".quote($session{form}{companyName})." where name='companyName'",$session{dbh}); WebGUI::SQL->write("update settings set value=".quote($session{form}{companyEmail})." where name='companyEmail'",$session{dbh}); WebGUI::SQL->write("update settings set value=".quote($session{form}{companyURL})." where name='companyURL'",$session{dbh}); + WebGUI::SQL->write("update settings set value=".quote($session{form}{authMethod})." where name='authMethod'",$session{dbh}); + WebGUI::SQL->write("update settings set value=".quote($session{form}{ldapURL})." where name='ldapURL'",$session{dbh}); + WebGUI::SQL->write("update settings set value=".quote($session{form}{ldapId})." where name='ldapId'",$session{dbh}); + WebGUI::SQL->write("update settings set value=".quote($session{form}{ldapIdName})." where name='ldapIdName'",$session{dbh}); + WebGUI::SQL->write("update settings set value=".quote($session{form}{ldapPasswordName})." where name='ldapPasswordName'",$session{dbh}); return ""; } else { return WebGUI::Privilege::insufficient(); diff --git a/lib/WebGUI/Operation/Trash.pm b/lib/WebGUI/Operation/Trash.pm index c72a07c42..eb4bf7121 100644 --- a/lib/WebGUI/Operation/Trash.pm +++ b/lib/WebGUI/Operation/Trash.pm @@ -47,7 +47,7 @@ sub _recursePageTree { sub www_purgeTrash { my ($output); if (WebGUI::Privilege::isInGroup(3)) { - $output = '

Please Confirm

'; + $output = '

Please Confirm

'; $output .= 'Are you certain that you wish to purge all the pages and widgets in the trash?

'; $output .= '

'; diff --git a/lib/WebGUI/Operation/User.pm b/lib/WebGUI/Operation/User.pm index 9f6ffd08a..32204ca9e 100644 --- a/lib/WebGUI/Operation/User.pm +++ b/lib/WebGUI/Operation/User.pm @@ -26,13 +26,18 @@ our @EXPORT = qw(&www_addUser &www_addUserSave &www_deleteUser &www_deleteUserCo #------------------------------------------------------------------- sub www_addUser { - my ($output, %hash); + my ($output, %hash, @array); if (WebGUI::Privilege::isInGroup(3)) { $output .= '

Add User

'; $output .= WebGUI::Form::hidden("op","addUserSave"); $output .= ''; $output .= ''; - $output .= ''; + $output .= ''; + %hash = ('WebGUI'=>'WebGUI', 'LDAP'=>'LDAP'); + $array[0] = $session{setting}{authMethod}; + $output .= ''; + $output .= ''; + $output .= ''; $output .= ''; $output .= ''; %hash = WebGUI::SQL->buildHash("select groupId,groupName from groups where groupName<>'Reserved' order by groupName",$session{dbh}); @@ -53,7 +58,7 @@ sub www_addUserSave { $encryptedPassword = Digest::MD5::md5_base64($session{form}{identifier}); $passwordStatement = ', identifier='.quote($encryptedPassword); $uid = getNextId("userId"); - WebGUI::SQL->write("insert into user set userId=$uid, username=".quote($session{form}{username}).$passwordStatement.", email=".quote($session{form}{email}).", icq=".quote($session{form}{icq}),$session{dbh}); + WebGUI::SQL->write("insert into user set userId=$uid, username=".quote($session{form}{username}).$passwordStatement.", authMethod=".quote($session{form}{authMethod}).", ldapURL=".quote($session{form}{ldapURL}).", connectDN=".quote($session{form}{connectDN}).", email=".quote($session{form}{email}).", icq=".quote($session{form}{icq}),$session{dbh}); @groups = $session{cgi}->param('groups'); foreach $gid (@groups) { WebGUI::SQL->write("insert into groupings set groupId=$gid, userId=$uid",$session{dbh}); @@ -99,9 +104,14 @@ sub www_editUser { $output .= WebGUI::Form::hidden("op","editUserSave"); $output .= WebGUI::Form::hidden("uid",$session{form}{uid}); $output .= '
Username'.WebGUI::Form::text("username",20,30).'
Password'.WebGUI::Form::password("identifier",20,30).'
Password'.WebGUI::Form::password("identifier",20,30).'
Authentication Method'.WebGUI::Form::selectList("authMethod",\%hash, \@array).'
LDAP URL'.WebGUI::Form::text("ldapURL",20,2048,$session{setting}{ldapURL}).'
Connect DN'.WebGUI::Form::text("connectDN",20,255).'
Email address'.WebGUI::Form::text("email",20,255).'
ICQ UIN'.WebGUI::Form::text("icq",20,30).'
'; - $output .= ''; - $output .= ''; - $output .= ''; + $output .= ''; + $output .= ''; + %hash = ('WebGUI'=>'WebGUI', 'LDAP'=>'LDAP'); + $array[0] = $user{authMethod}; + $output .= ''; + $output .= ''; + $output .= ''; + $output .= ''; $output .= ''; %hash = WebGUI::SQL->buildHash("select groupId,groupName from groups where groupName<>'Reserved' order by groupName",$session{dbh}); @array = WebGUI::SQL->buildArray("select groupId from groupings where userId=$session{form}{uid}",$session{dbh}); @@ -124,7 +134,7 @@ sub www_editUserSave { $passwordStatement = ', identifier='.quote($encryptedPassword); } $encryptedPassword = Digest::MD5::md5_base64($session{form}{identifier1}); - WebGUI::SQL->write("update user set username=".quote($session{form}{username}).$passwordStatement.", email=".quote($session{form}{email}).", icq=".quote($session{form}{icq})." where userId=".$session{form}{uid},$session{dbh}); + WebGUI::SQL->write("update user set username=".quote($session{form}{username}).$passwordStatement.", authMethod=".quote($session{form}{authMethod}).", ldapURL=".quote($session{form}{ldapURL}).", connectDN=".quote($session{form}{connectDN}).", email=".quote($session{form}{email}).", icq=".quote($session{form}{icq})." where userId=".$session{form}{uid},$session{dbh}); WebGUI::SQL->write("delete from groupings where userId=$session{form}{uid}",$session{dbh}); @groups = $session{cgi}->param('groups'); foreach $gid (@groups) { diff --git a/lib/WebGUI/Session.pm b/lib/WebGUI/Session.pm index 8cbf43e93..536ec3d78 100644 --- a/lib/WebGUI/Session.pm +++ b/lib/WebGUI/Session.pm @@ -98,7 +98,7 @@ sub open { foreach ($config->param) { $CONFIG{$_} = $config->param($_); } - $dbh = DBI->connect($CONFIG{dsn}, $CONFIG{dbuser}, $CONFIG{dbpass}); + $dbh = DBI->connect($CONFIG{dsn}, $CONFIG{dbuser}, $CONFIG{dbpass}, { RaiseError => 1, AutoCommit => 1 }); $query = CGI->new(); foreach ($query->param) { $FORM{$_} = $query->param($_); diff --git a/lib/WebGUI/Widget/Article.pm b/lib/WebGUI/Widget/Article.pm index 1e86e204d..ec76c0680 100644 --- a/lib/WebGUI/Widget/Article.pm +++ b/lib/WebGUI/Widget/Article.pm @@ -38,7 +38,7 @@ sub www_add { $output .= WebGUI::Form::hidden("func","addSave"); $output .= '
username'.WebGUI::Form::text("username",20,30,$user{username}).'
password'.WebGUI::Form::password("identifier",20,30,"password").'
email address'.WebGUI::Form::text("email",20,255,$user{email}).'
Username'.WebGUI::Form::text("username",20,30,$user{username}).'
Password'.WebGUI::Form::password("identifier",20,30,"password").'
Authentication Method'.WebGUI::Form::selectList("authMethod",\%hash,\@array).'
LDAP URL'.WebGUI::Form::text("ldapURL",20,2048,$user{ldapURL}).'
Connect DN'.WebGUI::Form::text("connectDN",20,255,$user{connectDN}).'
Email Address'.WebGUI::Form::text("email",20,255,$user{email}).'
ICQ UIN'.WebGUI::Form::text("icq",20,30,$user{icq}).'
'; $output .= ''; - $output .= ''; + $output .= ''; $output .= ''; $output .= ''; $output .= ''; diff --git a/lib/WebGUI/Widget/Poll.pm b/lib/WebGUI/Widget/Poll.pm index e569073e6..02f540632 100644 --- a/lib/WebGUI/Widget/Poll.pm +++ b/lib/WebGUI/Widget/Poll.pm @@ -69,6 +69,7 @@ sub _viewResults { $output .= '
Title'.WebGUI::Form::text("title",20,30,'Article').'
Display the title?'.WebGUI::Form::checkbox("displayTitle",1).'
Display the title?'.WebGUI::Form::checkbox("displayTitle",1,1).'
Process macros?'.WebGUI::Form::checkbox("processMacros",1,1).'
Start Date'.WebGUI::Form::text("startDate",20,30,'01/01/2000',1).'
End Date'.WebGUI::Form::text("endDate",20,30,'01/01/2100',1).'
  '.round(100*$data[0]/$totalResponses).'%
'; } } + $output .= '
Total Votes: '.$totalResponses.''; } return $output; } diff --git a/testEnvironment.pl b/testEnvironment.pl index 8b1f602b1..c6396b2e5 100644 --- a/testEnvironment.pl +++ b/testEnvironment.pl @@ -70,8 +70,16 @@ if (eval { require Digest::MD5 }) { print "Please install.\n"; } +print "Net::LDAP module:\t"; +if (eval { require Net::LDAP }) { + print "OK\n"; +} else { + print "Please install.\n"; +} + +# this is here to insure they installed correctly. print "WebGUI modules:\t\t"; -if (eval { require WebGUI }) { +if (eval { require WebGUI } && eval { require WebGUI::SQL }) { print "OK\n"; } else { print "Please install.\n"; @@ -89,7 +97,6 @@ if (eval { require Data::Config }) { ################################### print "Config file:\t\t"; -use Data::Config; my ($config); $config = new Data::Config './etc/WebGUI.conf'; unless (defined $config) { @@ -111,8 +118,6 @@ unless (defined $config) { ################################### print "Database connection:\t"; -use DBI; -use WebGUI::SQL; my ($dbh, $test); $dbh = DBI->connect($config->param('dsn'), $config->param('dbuser'), $config->param('dbpass')); unless (defined $dbh) { @@ -137,7 +142,6 @@ print "Latest version:\t\t"; use LWP::UserAgent; use HTTP::Request; use HTTP::Headers; -use WebGUI; my ($header, $userAgent, $request, $response, $version, $referer); $userAgent = new LWP::UserAgent; $userAgent->agent("WebGUI-Check/1.0");