Prev | Next | newsItem

manila.newsItem.create

Thu, Aug 23, 2001; by Jake Savin.

Syntax 

manila.newsItem.create (username, password, siteName, title, url, description, department, flPostToHomePage)

Params 

username is a string which identifies a member of the Manila site, who has permission to create news items.

password is a string, which is the password for the user specified by username.

siteName is the canonical name of the Manila site.

title is a string specifying the title for the news item.

url is a string specifying the URL that the news item links to.

description is a string specifying some descriptive text for the news item.

department is a string which specifies the department for the news item.

flPostToHomePage is a boolean. If true, then the news item will be posted to the home page immediately. If false, then the news item will be created but not posted to the home page.

Action 

Creates a new news item in a Manila site.

Returns 

The number identifying the discussion group message, which contains the newly created news item.

Examples 

manila.newsItem.create ("bull@mancuso.com", "not$likely", "bullManilaWebsite", "Scripting News", "http://www.scripting.com/", "This is a link to Scripting News. I visit every day!", "", true)

Return value: 7

manila.newsItem.create ("bull@mancuso.com", "notlikely", "bullManilaWebsite", "Slashdot", "http://slashdot.org/", "This is a link to Slashdot.", "", false)

Return value: 8

Errors 

If the user does not have permission to create news items, or does not have access to the discussion group, then an error will be generated.

If the flPostToHomePage is true, and the user does not have permission to post news items to the home page, then an error will be generated, and no news item will be created.

See Also 

manila.newsItem.edit

Prev | Next | newsItem