Prev | Next | newsItem

manila.newsItem.edit

Thu, Aug 23, 2001; by Jake Savin.

Syntax 

manila.newsItem.edit (username, password, sitename, msgnum, title, url, description, department, flPostToHomePage)

Params 

username is a string which identifies a member of the Manila site, who has permission to edit the news item, which is either the creator of the news item, or the managing editor of the site.

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

siteName is the canonical name of the Manila site.

msgnum is an integer, which specifies the number of the discussion group message which contains the news item.

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 not be posted to the home page.

Action 

Modifies (edits) a new news item in a Manila site.

Returns 

true

Examples 

manila.newsItem.edit ("bull@mancuso.com", "notlikely", "bullManilaWebsite", 7, "", "http:\//scriptingnews.userland.com/backIssues/2001/08/23", "A link to Scripting News archive page for 8/23/2001", "", true)

Return value: true

manila.newsItem.edit ("bull@mancuso.com", "notlikely", "bullManilaWebsite", 8, "", "", "Changed description for the news item stored in message number 8.", "", false)

Return value: true

Errors 

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.

Notes 

If the value of title, url, description or department is the empty string, then no change will be made to the corresponding value in the existing news item. In order to change a single value in a news item, pass in the empty string for the remaining values.

If the news item has already been posted to the home page, then flPostToHome page is ignored. In Manila, there's no way to remove a news item from the home page, without deleting the message that contains the news item.

See Also 

manila.newsItem.create

Prev | Next | newsItem