<![CDATA[Subscribers Archive Feed]]> http://us4.campaign-archive.com/feed?u=427153c482114d70024e1dc1a&id=60aff5b9cd&tpl=1 Thu, 23 May 2013 18:24:58 +0000 Zend_Feed http://blogs.law.harvard.edu/tech/rss <![CDATA[The Daily WordPress Reference: get_post()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=8e174aa94c http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=8e174aa94c Parameters $post_id (integer) (required) The ID of the post you'd like to fetch. You must pass a variable containing an integer (e.g. $id). A literal integer (e.g. get_post(7)) will cause a fatal error (Only variables can be passed for reference or Cannot pass parameter 1 by reference). Default: None $output (string) (optional) How you'd like the result. OBJECT - (default) returns an object ARRAY_A - Returns an associative array of field names to values ARRAY_N - returns a numeric array of field values Default: OBJECT Return Values In case of failure, this function returns null. The fields returned are: ID (integer) The post ID post_author (integer) The post author's ID post_date (string) The datetime of the post (YYYY-MM-DD HH:MM:SS) post_date_gmt (string) The GMT datetime of the post (YYYY-MM-DD HH:MM:SS) post_content (string) The post's contents post_title (string) The post's title post_category (integer) The post category's ID. Note that this will always be 0 (zero) from wordpress 2.1 onwards. To determine a post's category or categories, use get_the_category(). post_excerpt (string) The post excerpt post_status (string) The post status (publish|pending|draft|private|static|object|attachment|inherit|future|trash) comment_status (string) The comment status (open|closed|registered_only) ping_status (string) The pingback/trackback status (open|closed) post_password (string) The post password post_name (string) The post's URL slug to_ping (string) URLs to be pinged pinged (string) URLs already pinged post_modified (string) The last modified datetime of the post (YYYY-MM-DD HH:MM:SS) post_modified_gmt (string) The last modified GMT datetime of the post (YYYY-MM-DD HH:MM:SS) post_content_filtered (string) post_parent (integer) The parent post's ID (for attachments, etc) guid (string) A link to the post. Note: One cannot rely upon the GUID to be the permalink (as it previously was in pre-2.5), Nor can you expect it to be a valid link to the post. It's merely a unique identifier, which so happens to be a link to the post at present. menu_order (integer) post_type (string) (post|page|attachment) post_mime_type (string) Mime Type (for attachments, etc) comment_count (integer) Number of comments Examples To get the title for a post with ID 7: post_title; ?> More informations http://codex.wordpress.org/Function_Reference/get_post DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=8e174aa94c 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: get_post()
The Daily WordPress Reference
get_post()
Takes a post ID and returns the database record for that post. You can specify, by means of the $output parameter, how you would like the results returned.Retrieves all category IDs.
Usage 
<?php get_post( $post_id, $output ); ?> 
Parameters
$post_id
(integer) (required) The ID of the post you'd like to fetch. You must pass a variable containing an integer (e.g. $id). A literal integer (e.g. get_post(7)) will cause a fatal error (Only variables can be passed for reference or Cannot pass parameter 1 by reference).
Default: None
$output
(string) (optional) How you'd like the result.
  • OBJECT - (default) returns an object
  • ARRAY_A - Returns an associative array of field names to values
  • ARRAY_N - returns a numeric array of field values
Default: OBJECT
Return values

In case of failure, this function returns null.

The fields returned are:

ID
(integer) The post ID
post_author
(integer) The post author's ID
post_date
(string) The datetime of the post (YYYY-MM-DD HH:MM:SS)
post_date_gmt
(string) The GMT datetime of the post (YYYY-MM-DD HH:MM:SS)
post_content
(string) The post's contents
post_title
(string) The post's title
post_category
(integer) The post category's ID. Note that this will always be 0 (zero) from wordpress 2.1 onwards. To determine a post's category or categories, use get_the_category().
post_excerpt
(string) The post excerpt
post_status
(string) The post status (publish|pending|draft|private|static|object|attachment|inherit|future|trash)
comment_status
(string) The comment status (open|closed|registered_only)
ping_status
(string) The pingback/trackback status (open|closed)
post_password
(string) The post password
post_name
(string) The post's URL slug
to_ping
(string) URLs to be pinged
pinged
(string) URLs already pinged
post_modified
(string) The last modified datetime of the post (YYYY-MM-DD HH:MM:SS)
post_modified_gmt
(string) The last modified GMT datetime of the post (YYYY-MM-DD HH:MM:SS)
post_content_filtered
(string)
post_parent
(integer) The parent post's ID (for attachments, etc)
guid
(string) A link to the post. Note: One cannot rely upon the GUID to be the permalink (as it previously was in pre-2.5), Nor can you expect it to be a valid link to the post. It's merely a unique identifier, which so happens to be a link to the post at present.
menu_order
(integer)
post_type
(string) (post|page|attachment)
post_mime_type
(string) Mime Type (for attachments, etc)
comment_count
(integer) Number of comments
Examples
To get the title for a post with ID 7: 
<?php
$my_id = 7;
$post_id_7 = get_post($my_id); 
$title = $post_id_7->post_title;
?> 
More information

Liked this function?
You might also like these books:
 Share it:
share on Twitter Like The Daily WordPress Reference: get_post() on Facebook
 Or Donate to the project:
Donata via Paypal
(Why Donate?)

]]> Fri, 16 Nov 2012 13:00:00 +0000 <![CDATA[The Daily WordPress Reference: get_all_category_ids()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=54f399cb27 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=54f399cb27 Parameters None. Return Values object List of all of the category IDs. Examples To print a list of categories by id: name More informations http://codex.wordpress.org/Function_Reference/get_all_category_ids DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=54f399cb27 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: get_all_category_ids()
The Daily WordPress Reference
get_all_category_ids()
Retrieves all category IDs.
Usage 
<?php get_all_category_ids() ?>
Parameters
None.
Return values
(object List)
   of all of the category IDs.
Examples

To print a list of categories by id: name

<?php
$category_ids = get_all_category_ids();

foreach($category_ids as $cat_id) {
  $cat_name = get_cat_name($cat_id);
  echo $cat_id . ': ' . $cat_name;
}
?> 
More information

Liked this function?
You might also like these books:
 Share it:
share on Twitter Like The Daily WordPress Reference: get_all_category_ids() on Facebook
 Or Donate to the project:
Donata via Paypal
(Why Donate?)

]]> Tue, 13 Nov 2012 13:00:00 +0000 <![CDATA[The Daily WordPress Reference: is_author()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=83751bbb5c http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=83751bbb5c Parameters $author (string) (optional) Author ID or Author Nickname Default: None Return Values (boolean) True on success, false on failure. Examples is_author(); // When any Author page is being displayed. is_author('4'); // When the archive page for Author number (ID) 4 is being displayed. is_author('Vivian'); // When the archive page for the Author with Nickname "Vivian" is being displayed. is_author('john-jones'); // When the archive page for the Author with Nicename "john-jones" is being displayed. is_author(array(4,'john-jones','Vivian')); // When the archive page for the author is either user ID 4, or user_nicename "john-jones", or nickname "Vivian". Note: the array ability was added at Version 2.5. More informations http://codex.wordpress.org/Function_Reference/is_author DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=83751bbb5c 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: is_author()
The Daily WordPress Reference
is_author()
This Conditional Tag checks if an Author archive page is being displayed. This is a boolean function, meaning it returns either TRUE or FALSE.
Usage 
<?php is_author($author); ?>
Parameters
$author
(string) (optional) Author ID or Author Nickname
Default: None
Return values
(boolean)
   True on success, false on failure.
Examples 
is_author();
// When any Author page is being displayed.

is_author('4');
/********************************************
When the archive page for Author
number (ID) 4 is being displayed.
********************************************/

is_author('Vivian');
/********************************************
When the archive page for the Author with
Nickname "Vivian" is being displayed.
********************************************/

is_author('john-jones');
/********************************************
When the archive page for the Author with
Nicename "john-jones" is being displayed.
********************************************/

is_author(array(4,'john-jones','Vivian'));
/***********************************************
// When the archive page for the author is 
either user ID 4, or user_nicename "john-jones",
or nickname "Vivian".  Note: the array ability
was added at Version 2.5.
***********************************************/
More information

Liked this function?
You might also like these books:
 Share it:
share on Twitter Like The Daily WordPress Reference: is_author() on Facebook
 Or Donate to the project:
Donata via Paypal
(Why Donate?)

]]> Mon, 12 Nov 2012 13:00:00 +0000 <![CDATA[The Daily WordPress Reference: wp_schedule_single_event()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=d4112a1b5e http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=d4112a1b5e Note that scheduling an event within 10 minutes of an event of the same name will be ignored, unless you pass unique values for $args to each scheduled event. See Function_Reference/wp_next_scheduled for more information. Attempts to schedule an event after an event of the same name and $args will also be ignored. Parameters $timestamp (integer) (required) The time you want the event to occur. This must be in a UNIX timestamp format. Default: None $hook (string) (required) The name of an action hook to execute. Default: None $args (array) (optional) Arguments to pass to the hook function(s) Default: None Return Values false | null) False if the event was cancelled by a plugin, Null otherwise. Examples Schedule an event one hour from now function do_this_in_an_hour() { // do something } add_action('my_new_event','do_this_in_an_hour'); // put this line inside a function, // presumably in response to something the user does // otherwise it will schedule a new event on every page visit wp_schedule_single_event(time()+3600, 'my_new_event'); // time()+3600 = one hour from now. More informations http://codex.wordpress.org/Function_Reference/wp_schedule_single_event DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=d4112a1b5e 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: wp_schedule_single_event()
The Daily WordPress Reference
wp_schedule_single_event()
Schedules a hook which will be executed once by the WordPress actions core at a time which you specify. The action will fire off when someone visits your WordPress site, if the schedule time has passed.
Usage 
<?php
wp_schedule_single_event(time(), 'my_schedule_hook'); 
?> 

Note that scheduling an event within 10 minutes of an event of the same name will be ignored, unless you pass unique values for $args to each scheduled event. See Function_Reference/wp_next_scheduled for more information.

Attempts to schedule an event after an event of the same name and $args will also be ignored.
Parameters
$timestamp
(integer) (required) The time you want the event to occur. This must be in a UNIX timestamp format.
Default: None
$hook
(string) (required) The name of an action hook to execute.
Default: None
$args
(array) (optional) Arguments to pass to the hook function(s)
Default: None
Return values
(false | null)
    False if the event was cancelled by a plugin, Null otherwise.
Examples

Schedule an event one hour from now

function do_this_in_an_hour() {
// do something
}
add_action('my_new_event','do_this_in_an_hour');

// put this line inside a function, 
// presumably in response to something the user does
// otherwise it will schedule a new event on every page visit

wp_schedule_single_event(time()+3600, 'my_new_event');

// time()+3600 = one hour from now.
More information

Liked this function?
You might also like these books:
 Share it:
share on Twitter Like The Daily WordPress Reference: wp_schedule_single_event() on Facebook
 Or Donate to the project:
Donata via Paypal
(Why Donate?)

]]> Sat, 10 Nov 2012 13:00:00 +0000 <![CDATA[The Daily WordPress Reference: wp_nonce_field()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=45512fd624 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=45512fd624 Parameters $action (string) (optional) Action name. This is the unique identifier for this nonce. Optional but recommended. Default: -1 $name (string) (optional) Nonce name. This is the name of the hidden field form variable (once submitted you can access the nonce via $_POST[$name]). Default: "_wpnonce" $referer (boolean) (optional) default true. Whether to set the referer field for validation. Default: true $echo (boolean) (optional) default true. Whether to display or return hidden form field. Default: true Return Values (string) Nonce field. Examples While less secure than the examples that follow, this is the simplest implementation which omits all arguments. In your form add the following: It's better to name your action and nonce in your form. Enter values for the first and second arguments to print the necessary hidden field:
Then in the page where it is being submitted to, you may verify it using the wp_verify_nonce() function. Notice that you have to manually retrieve the nonce (from the $_POST array in this example), and the name of the action is the 2nd parameter instead of the first: The Daily WordPress Reference: wp_nonce_field()
The Daily WordPress Reference
wp_nonce_field()

Retrieve or display nonce hidden field for forms.

The nonce field is used to validate that the contents of the form came from the location on the current site and not somewhere else. The nonce does not offer absolute protection, but should protect against most cases. It is very important to use nonce fields in forms.

If you set $echo to false and set $referer to true, then you will need to retrieve the referer field using wp_referer_field(). If you have the $referer set to true and are echoing the nonce field, it will also echo the referer field.

The $action and $name are optional, but if you want to have better security, it is strongly suggested to set those two parameters. It is easier to just call the function without any parameters, because validation of the nonce doesn't require any parameters, but since crackers know what the default is it won't be difficult for them to find a way around your nonce and cause damage.

The input name will be whatever $name value you gave. The input value will be the nonce creation value.
Usage 
<?php
wp_nonce_field( $action, $name, $referer, $echo ) 
?>
Parameters
$action
(string) (optional) Action name. This is the unique identifier for this nonce. Optional but recommended.
Default: -1
$name
(string) (optional) Nonce name. This is the name of the hidden field form variable (once submitted you can access the nonce via $_POST[$name]).
Default: "_wpnonce"
$referer
(boolean) (optional) default true. Whether to set the referer field for validation.
Default: true
$echo
(boolean) (optional) default true. Whether to display or return hidden form field.
Default: true
Return values
(string)
    Nonce field.
Examples

While less secure than the examples that follow, this is the simplest implementation which omits all arguments. In your form add the following:

<?php wp_nonce_field(); ?>

It's better to name your action and nonce in your form. Enter values for the first and second arguments to print the necessary hidden field:

<form method="post">
   <!-- some inputs here ... -->
   <?php
   wp_nonce_field('name_of_my_action',
                  'name_of_nonce_field'); 
   ?>
</form>

Then in the page where it is being submitted to, you may verify it using the wp_verify_nonce() function. Notice that you have to manually retrieve the nonce (from the $_POST array in this example), and the name of the action is the 2nd parameter instead of the first:

<?php
if ( empty($_POST) || 
    !wp_verify_nonce($_POST['name_of_nonce_field'],
                            'name_of_my_action') )
{
   print 'Sorry, your nonce did not verify.';
   exit;
}
else
{
   // process form data
}

If you are submitting and processing the form inside the WP administration area, you may verify the nonce using the check_admin_referer() function:

<?php
/****************************************
if this fails, check_admin_referer()
will automatically print a "failed" page and die.
****************************************/
if ( !empty($_POST) && 
     check_admin_referer('name_of_my_action',
                         'name_of_nonce_field') )
{
   // process form data
}
More information

Liked this function?
You might also like these books:
 Share it:
share on Twitter Like The Daily WordPress Reference: wp_nonce_field() on Facebook
 Or Donate to the project:
Donata via Paypal
(Why Donate?)

]]> Fri, 09 Nov 2012 13:00:00 +0000 <![CDATA[The Daily WordPress Reference: add_node()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=a0cd1fb954 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=a0cd1fb954 add_node( $args ); ?> Parameters $args (array) (required) An array of arguments. Default: None Arguments id (string) (required) The ID of the node. Default: false title (string) (optional) The text that will be visible in the Toolbar. Including html tags is allowed. Default: false parent (string) (optional) The ID of the parent node. Default: false href (string) (optional) The 'href' attribute for the link. If 'href' is not set the node will be a text node. Default: false group (boolean) (optional) This will make the node a group (node) if set to 'true'. Group nodes are not visible in the Toolbar, but nodes added to it are. See add_group(). Default: false meta (array) (optional) An array of meta data for the node. Default: array() 'html' - The html used for the node. 'class' - The class attribute for the list item containing the link or text node. 'onclick' - The onclick attribute for the link. This will only be set if the 'href' argument is present. 'target' - The target attribute for the link. This will only be set if the 'href' argument is present. 'title' - The title attribute. Will be set to the link or to a div containing a text node. 'tabindex' - The tabindex attribute. Will be set to the link or to a div containing a text node. Return Values None. Examples Add a Page to the Toolbar This example will add a Page with a "my-toolbar-page" class to the Toolbar. It will be a top level item because the 'parent' argument is not set (it has no parent node). Put this in your theme's functions.php file. add_action( 'admin_bar_menu', 'toolbar_link_to_mypage', 999 ); function toolbar_link_to_mypage( $wp_admin_bar ) { global $wp_admin_bar; $args = array( 'id' => 'my_page', 'title' => 'My Page', 'href' => 'http://mysite.com/my-page/', 'meta' => array('class' => 'my-toolbar-page') ); $wp_admin_bar->add_node($args); } More informations http://codex.wordpress.org/Function_Reference/add_node DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=a0cd1fb954 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: add_node()
The Daily WordPress Reference
add_node()

This function is a method of the $wp_admin_bar global object (see: WP_Admin_Bar), and can be used to add a new item to the Toolbar. You can also use it to change the properties of an item that is already in the Toolbar.

The Toolbar replaces the Admin Bar since WordPress Version 3.3.

Toolbar items are also called "nodes". Nodes can be parents for other nodes, which creates dropdown menus. Group nodes together with add_group() to create distinct sections in a Toolbar menu.

Note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks.
Usage 
<?php $wp_admin_bar->add_node( $args ); ?>
Parameters
$args
(array) (required) An array of arguments.
Default: None
 
Arguments:
id
(string) (required) The ID of the node.
Default: false
title
(string) (optional) The text that will be visible in the Toolbar. Including html tags is allowed.
Default: false
parent
(string) (optional) The ID of the parent node.
Default: false
href
(string) (optional) The 'href' attribute for the link. If 'href' is not set the node will be a text node.
Default: false
group
(boolean) (optional) This will make the node a group (node) if set to 'true'. Group nodes are not visible in the Toolbar, but nodes added to it are. See add_group().
Default: false
meta
(array) (optional) An array of meta data for the node.
Default: array()
  • 'html' - The html used for the node.
  • 'class' - The class attribute for the list item containing the link or text node.
  • 'onclick' - The onclick attribute for the link. This will only be set if the 'href' argument is present.
  • 'target' - The target attribute for the link. This will only be set if the 'href' argument is present.
  • 'title' - The title attribute. Will be set to the link or to a div containing a text node.
  • 'tabindex' - The tabindex attribute. Will be set to the link or to a div containing a text node.
Return values
None.
Examples

Add a Page to the Toolbar

This example will add a Page with a "my-toolbar-page" class to the Toolbar. It will be a top level item because the 'parent' argument is not set (it has no parent node). Put this in your theme's functions.php file.

add_action( 'admin_bar_menu', 'toolbar_link_to_mypage', 999 );

function toolbar_link_to_mypage( $wp_admin_bar ) {
  global $wp_admin_bar;
  $args = array(
    'id' => 'my_page',
    'title' => 'My Page',
    'href' => 'http://mysite.com/my-page/',
    'meta' => array('class' => 'my-toolbar-page')
  );

  $wp_admin_bar->add_node($args);
}
More information

Liked this function?
You might also like these books:
 Share it:
share on Twitter Like The Daily WordPress Reference: add_node() on Facebook
 Or Donate to the project:
Donata via Paypal
(Why Donate?)

]]> Thu, 08 Nov 2012 13:00:00 +0000 <![CDATA[The Daily WordPress Reference: is_home()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=42fac7f155 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=42fac7f155 Parameters None. Return Values (boolean) True on success, false on failure. Examples The following example can be used in your sidebar to display different content when displaying home page. More informations http://codex.wordpress.org/Function_Reference/is_home DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=42fac7f155 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: is_home()
The Daily WordPress Reference
is_home()

This Conditional Tag checks if the main page is being displayed. This is a boolean function, meaning it returns either TRUE or FALSE.

Note: WordPress 2.1 handles this function differently than prior versions - See static Front Page. If you select a static Page as your frontpage (see is_front_page()), this tag will be applied to your "posts page".
Usage 
<?php is_home(); ?>
Parameters
None.
Return values
(boolean)
   True on success, false on failure.
Examples

The following example can be used in your sidebar to display different content when displaying home page.

<?php
if ( is_home() ) {
    // This is a homepage
} else {
    // This is not a homepage
}
?>
More information

Liked this function?
You might also like these books:
 Share it:
share on Twitter Like The Daily WordPress Reference: is_home() on Facebook
 Or Donate to the project:
Donata via Paypal
(Why Donate?)

]]> Wed, 07 Nov 2012 13:00:00 +0000 <![CDATA[The Daily WordPress Reference: wp_list_bookmarks()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=36ccd0b57f http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=36ccd0b57f Links panel. This Template Tag allows the user to control how the bookmarks are sorted and displayed. NOTE: wp_list_bookmarks() intended to replace the deprecated Template tags get_links_list() and get_links(). Usage Default Usage 'name', 'order' => 'ASC', 'limit' => -1, 'category' => ' ', 'exclude_category' => ' ', 'category_name' => ' ', 'hide_invisible' => 1, 'show_updated' => 0, 'echo' => 1, 'categorize' => 1, 'title_li' => __('Bookmarks'), 'title_before' => '

', 'title_after' => '

', 'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat', 'category_before' => '
  • ', 'category_after' => '
    • ' ); ?> By default, the function shows: Bookmarks divided into Categories with a Category name heading All bookmarks included, regardless of Category Name or Category ID Sorts the list by name An image if one is included A space between the image and the text Shows the description of the bookmark Does not show the ratings Unless limit is set, shows all bookmarks Displays bookmarks Parameters categorize (boolean) Bookmarks should be shown within their assigned Categories or not. 1 (True) - Default 0 (False) category (string) Comma separated list of numeric Category IDs to be displayed. If none is specified, all Categories with bookmarks are shown. Defaults to (all Categories). exclude_category (string) Comma separated list of numeric Category IDs to be excluded from display. Defaults to (no categories excluded). category_name (string) The name of a Category whose bookmarks will be displayed. If none is specified, all Categories with bookmarks are shown. Defaults to (all Categories). category_before (string) Text to place before each category. Defaults to '
  • ' . category_after (string) Text to place after each category. Defaults to '
    • ' . class (string) The class each category li will have on it. Defaults to 'linkcat' . (This parameter was added with Version 2.2) category_orderby (string) Value to sort Categories on. Valid options: 'name' - Default 'id' 'slug' 'count' 'term_group' (not used yet) category_order (string) Sort order, ascending or descending for the category_orderby parameter. Valid values: ASC - Default DESC title_li (string) Text for the heading of the links list. Defaults to '__('Bookmarks')', which displays "Bookmarks" (the __('') is used for localization purposes). Only used when categorize are set to 0 [false] (else the category names will be used instead). If 'title_li' is set to null (0) value, no heading is displayed, and the list will not be wrapped with
      ,
    tags (be sure to pass the categorize option to 0 [false] to this option takes effect). title_before (string) Text to place before each Category description if 'categorize' is 1 [true], or text defined in "title_li" if 'categorize' is 0 [false]. Defaults to '

    '. title_after (string) Text to place after each Category description if 'categorize' is 1 [true], or text defined in "title_li" if 'categorize' is 0 [false]. Defaults to '

    '. show_private (boolean) Should a Category be displayed even if the Category is considered private. Ignore the admin setting and show private Categories (TRUE) or do NOT show private Categories (FALSE). 1 (True) 0 (False) - Default include (string) Comma separated list of numeric bookmark IDs to include in the output. For example, 'include=1,3,6' means to return or echo bookmark IDs 1, 3, and 6. If the include string is used, the category, category_name, and exclude parameters are ignored. Defaults to (all Bookmarks). exclude (string) Comma separated list of numeric bookmark IDs to exclude. For example, 'exclude=4,12' means that bookmark IDs 4 and 12 will NOT be returned or echoed. Defaults to (exclude nothing). orderby (string) Value to sort bookmarks on. This can be a COMMA separated list of values. Defaults to 'name' unless you pass the value of '' (empty), in which case it sets to 'id'. Valid options: 'id' (use 'link_id' with WP 3.2 and later) 'url' 'name' - Default 'target' 'description' 'owner' - User who added bookmark through bookmarks Manager. 'rating' 'updated' Note: the link_updated field does not track local modifications. It tracks when whatever the link points to is updated via remote requests to pingomatic. 'rel' - bookmark relationship (XFN). 'notes' 'rss' 'length' - The length of the bookmark name, shortest to longest. 'rand' - Display bookmarks in random order. order (string) Bookmarks display sorting order, ascending or descending as defined in the 'orderby' parameter. Valid values: ASC - Default DESC limit (integer) Maximum number of bookmarks to display. Default is -1 (all bookmarks). before (string) Text to place before each bookmark. Defaults to '
  • '. after (string) Text to place after each bookmark. Defaults to '
    • '. link_before (string) Text to place before the text of each bookmark, inside the hyperlink code. There is no set default. (This parameter was added with Version 2.7) link_after (string) Text to place after the text of each bookmark. There is no set default. (This parameter was added with Version 2.7) between (string) Text to place between each bookmark/image and its description. Defaults to '\n' (newline). show_images (boolean) Should images for bookmarks be shown (TRUE) or not (FALSE). 1 (True) - Default 0 (False) show_description (boolean) Should the description be displayed (TRUE) or not (FALSE). Valid when show_images is FALSE, or an image is not defined. 1 (True) 0 (False) - Default show_name (boolean) Displays the text of a link when (TRUE). Works when show_images is TRUE. (This parameter was added with Version 2.7) 1 (True) 0 (False) - Default show_rating (boolean) Should rating stars/characters be displayed (TRUE) or not (FALSE). 1 (True) 0 (False) - Default show_updated (boolean) Should the last updated timestamp be displayed (TRUE) or not (FALSE). Note that link_updated does not track local modifications. It tracks when whatever the link points to is updated via remote requests to pingomatic. 1 (True) 0 (False) - Default hide_invisible (boolean) Should bookmark be displayed even if it's Visible setting is No. Abides by admin setting (TRUE) or does no abide by admin setting (FALSE). 1 (True) - Default 0 (False) echo (boolean) Display bookmarks (TRUE) or return them for use by PHP (FALSE). 1 (True) - Default 0 (False) Return Values (string|null) Will only return if echo option is set to not echo. Default is not return anything. Examples Simple List Displays all bookmarks with the title "Bookmarks" and with items wrapped in
  • tags. The title is wrapped in h2 tags. More informations http://codex.wordpress.org/Function_Reference/wp_list_bookmarks DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=36ccd0b57f 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: wp_list_bookmarks()
    The Daily WordPress Reference
    wp_list_bookmarks()

    Displays bookmarks found in the Administration > Links panel. This Template Tag allows the user to control how the bookmarks are sorted and displayed.

    NOTE: wp_list_bookmarks() intended to replace the deprecated Template tags get_links_list() and get_links().
    Usage 
    <?php wp_list_bookmarks( $args ); ?> 
    Default Usage 
    <?php 
$args = array(
            'orderby'          => 'name',
	    'order'            => 'ASC',
	    'limit'            => -1,
	    'category'         => ' ',
	    'exclude_category' => ' ',
	    'category_name'    => ' ',
	    'hide_invisible'   => 1,
	    'show_updated'     => 0,
	    'echo'             => 1,
	    'categorize'       => 1,
	    'title_li'         => __('Bookmarks'),
	    'title_before'     => '<h2>',
	    'title_after'      => '</h2>',
	    'category_orderby' => 'name',
	    'category_order'   => 'ASC',
	    'class'            => 'linkcat',
	    'category_before'  => '<li id=%id class=%class>',
	    'category_after'   => '</li>' 
            ); 
?> 

    By default, the function shows:

    • Bookmarks divided into Categories with a Category name heading
    • All bookmarks included, regardless of Category Name or Category ID
    • Sorts the list by name
    • An image if one is included
    • A space between the image and the text
    • Shows the description of the bookmark
    • Does not show the ratings
    • Unless limit is set, shows all bookmarks
    • Displays bookmarks
    Parameters
    categorize 
    (boolean) Bookmarks should be shown within their assigned Categories or not.
    • 1 (True) - Default
    • 0 (False)
    category 
    (string) Comma separated list of numeric Category IDs to be displayed. If none is specified, all Categories with bookmarks are shown. Defaults to (all Categories).
    exclude_category 
    (string) Comma separated list of numeric Category IDs to be excluded from display. Defaults to (no categories excluded).
    category_name 
    (string) The name of a Category whose bookmarks will be displayed. If none is specified, all Categories with bookmarks are shown. Defaults to (all Categories).
    category_before 
    (string) Text to place before each category. Defaults to '<li id="[category id]" class="linkcat">' .
    category_after 
    (string) Text to place after each category. Defaults to '</li>' .
    class 
    (string) The class each category li will have on it. Defaults to 'linkcat' . (This parameter was added with Version 2.2)
    category_orderby 
    (string) Value to sort Categories on. Valid options:
    • 'name' - Default
    • 'id'
    • 'slug'
    • 'count'
    • 'term_group' (not used yet)
    category_order 
    (string) Sort order, ascending or descending for the category_orderby parameter. Valid values:
    • ASC - Default
    • DESC
    title_li 
    (string) Text for the heading of the links list. Defaults to '__('Bookmarks')', which displays "Bookmarks" (the __('') is used for localization purposes). Only used when categorize are set to 0 [false] (else the category names will be used instead). If 'title_li' is set to null (0) value, no heading is displayed, and the list will not be wrapped with <ul>, </ul> tags (be sure to pass the categorize option to 0 [false] to this option takes effect).
    title_before 
    (string) Text to place before each Category description if 'categorize' is 1 [true], or text defined in "title_li" if 'categorize' is 0 [false]. Defaults to '<h2>'.
    title_after 
    (string) Text to place after each Category description if 'categorize' is 1 [true], or text defined in "title_li" if 'categorize' is 0 [false]. Defaults to '</h2>'.
    show_private 
    (boolean) Should a Category be displayed even if the Category is considered private. Ignore the admin setting and show private Categories (TRUE) or do NOT show private Categories (FALSE).
    • 1 (True)
    • 0 (False) - Default
    include 
    (string) Comma separated list of numeric bookmark IDs to include in the output. For example, 'include=1,3,6' means to return or echo bookmark IDs 1, 3, and 6. If the include string is used, the category, category_name, and exclude parameters are ignored. Defaults to (all Bookmarks).
    exclude 
    (string) Comma separated list of numeric bookmark IDs to exclude. For example, 'exclude=4,12' means that bookmark IDs 4 and 12 will NOT be returned or echoed. Defaults to (exclude nothing).
    orderby 
    (string) Value to sort bookmarks on. This can be a COMMA separated list of values. Defaults to 'name' unless you pass the value of '' (empty), in which case it sets to 'id'. Valid options:
    • 'id' (use 'link_id' with WP 3.2 and later)
    • 'url'
    • 'name' - Default
    • 'target'
    • 'description'
    • 'owner' - User who added bookmark through bookmarks Manager.
    • 'rating'
    • 'updated' Note: the link_updated field does not track local modifications. It tracks when whatever the link points to is updated via remote requests to pingomatic.
    • 'rel' - bookmark relationship (XFN).
    • 'notes'
    • 'rss'
    • 'length' - The length of the bookmark name, shortest to longest.
    • 'rand' - Display bookmarks in random order.
    order 
    (string) Bookmarks display sorting order, ascending or descending as defined in the 'orderby' parameter. Valid values:
    • ASC - Default
    • DESC
    limit 
    (integer) Maximum number of bookmarks to display. Default is -1 (all bookmarks).
    before 
    (string) Text to place before each bookmark. Defaults to '<li>'.
    after 
    (string) Text to place after each bookmark. Defaults to '</li>'.
    link_before 
    (string) Text to place before the text of each bookmark, inside the hyperlink code. There is no set default. (This parameter was added with Version 2.7)
    link_after 
    (string) Text to place after the text of each bookmark. There is no set default. (This parameter was added with Version 2.7)
    between 
    (string) Text to place between each bookmark/image and its description. Defaults to '\n' (newline).
    show_images 
    (boolean) Should images for bookmarks be shown (TRUE) or not (FALSE).
    • 1 (True) - Default
    • 0 (False)
    show_description 
    (boolean) Should the description be displayed (TRUE) or not (FALSE). Valid when show_images is FALSE, or an image is not defined.
    • 1 (True)
    • 0 (False) - Default
    show_name 
    (boolean) Displays the text of a link when (TRUE). Works when show_images is TRUE. (This parameter was added with Version 2.7)
    • 1 (True)
    • 0 (False) - Default
    show_rating 
    (boolean) Should rating stars/characters be displayed (TRUE) or not (FALSE).
    • 1 (True)
    • 0 (False) - Default
    show_updated 
    (boolean) Should the last updated timestamp be displayed (TRUE) or not (FALSE). Note that link_updated does not track local modifications. It tracks when whatever the link points to is updated via remote requests to pingomatic.
    • 1 (True)
    • 0 (False) - Default
    hide_invisible 
    (boolean) Should bookmark be displayed even if it's Visible setting is No. Abides by admin setting (TRUE) or does no abide by admin setting (FALSE).
    • 1 (True) - Default
    • 0 (False)
    echo 
    (boolean) Display bookmarks (TRUE) or return them for use by PHP (FALSE).
    • 1 (True) - Default
    • 0 (False)
    Return values
    (string|null)
       Will only return if echo option is set to not echo.
       Default is not return anything.
    Examples

    Simple List

    Displays all bookmarks with the title "Bookmarks" and with items wrapped in <li> tags. The title is wrapped in h2 tags.

    <?php
wp_list_bookmarks('title_li=&category_before=&category_after='); 
?>
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: wp_list_bookmarks() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Tue, 06 Nov 2012 13:00:00 +0000 <![CDATA[The Daily WordPress Reference: home_url()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=4c62d409d9 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=4c62d409d9 Default Usage Parameters $path (string) (optional) Path relative to the home url. Default: None $scheme (string) (optional) Scheme to give the home url context. Currently 'http','https'. Default: null Return Values (string) Home url link with optional path appended. Examples $url = home_url(); echo $url; Output: http://www.example.com (Note the lack of a trailing slash) $url = home_url('/'); echo $url; More informations http://codex.wordpress.org/Function_Reference/home_url DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=4c62d409d9 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: home_url()
    The Daily WordPress Reference
    home_url()

    The home_url template tag retrieves the home url for the current site with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If scheme is 'http' or 'https', is_ssl() is overridden.

    In case of WordPress Network setup, use network_home_url() instead.
    Usage 
    <?php home_url( $path, $scheme ); ?>
    Default Usage 
    <?php echo home_url(); ?>
    Parameters
    $path
       (string) (optional) Path relative to the home url.
       Default: None
     
    $scheme
       (string) (optional) Scheme to give the
       home url context. Currently 'http','https'.
       Default: null
    Return values
    (string)
       Home url link with optional path appended.
    Examples 
    $url = home_url();
echo $url;

    Output: http://www.example.com

    (Note the lack of a trailing slash)

    $url = home_url('/');
echo $url;

    Output: http://www.example.com/
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: home_url() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Sat, 03 Nov 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: wp_enqueue_script()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=e4028d9171 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=e4028d9171 section. If this parameter is true the script is placed at the bottom of the . This requires the theme to have the wp_footer() hook in the appropriate place. Note that you have to enqueue your script before wp_head is run, even if it will be placed in the footer. Default: false Return Values None. Examples Load a script that depends on scriptaculous Add and load a new script that depends on Scriptaculous. This will cause WordPress to load Scriptaculous into the page before the new script. More informations http://codex.wordpress.org/Function_Reference/wp_enqueue_script DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=e4028d9171 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: wp_enqueue_script()
    The Daily WordPress Reference
    wp_enqueue_script()

    The safe and recommended method of adding JavaScript to a WordPress generated page is by using wp_enqueue_script(). This function includes the script if it hasn't already been included, and safely handles dependencies.
    Usage 
    wp_enqueue_script( 
     $handle
    ,$src
    ,$deps
    ,$ver
    ,$in_footer 
);

    Use the wp_enqueue_scripts action to call this function, or admin_enqueue_scripts to call it on the admin side, or use login_enqueue_scripts for login screens.
    Parameters
    $handle
       (string) (required) Name of the script. Lowercase string.
       Default: None
     
    $src
       (string) (optional) URL to the script.
       Example: "http://example.com/wp-includes/js/scriptaculous/scriptaculous.js".
       This parameter is only required when WordPress does not already
       know about this script. You should never hardcode URLs to local scripts
       use plugins_url() (for Plugins) and get_template_directory_uri() (for Themes) to get a proper URL.
       Default: false
     
    $deps
       (array) (optional) Array of handles of any script that
       this script depends on (scripts that must be loaded before this script).
       false if there are no dependencies. This parameter is only required when
       WordPress does not already know about this script.
       Default: array()
     
    $ver
       (string) (optional) String specifying the script version number,
       if it has one, which is concatenated to the end of the path as a query
       string. Defaults to false. 
       This parameter is used to ensure that the correct version is sent to the client
       regardless of caching, and so should be included if a version number
       is available and makes sense for the script.
       Default: false
     
    $in_footer
       (boolean) (optional) Normally scripts are placed in the <head> section.
       If this parameter is true the script is placed at the bottom of the <body>.
       This requires the theme to have the wp_footer() hook in the appropriate place.
       Default: false
    Return values
    None.
    Examples

    Load a script that depends on scriptaculous

    Add and load a new script that depends on Scriptaculous.
    This will cause WordPress to load Scriptaculous into the page before the new script.

    <?php
function my_scripts_method() {
	wp_enqueue_script(
		'newscript',
		plugins_url('/js/newscript.js', __FILE__),
		array('scriptaculous')
	);
}    
 
add_action('wp_enqueue_scripts', 'my_scripts_method');
?>
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: wp_enqueue_script() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Fri, 02 Nov 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: is_search()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=9c659376ce http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=9c659376ce Parameters None. Return Values (boolean) True on success, false on failure. Examples More informations http://codex.wordpress.org/Function_Reference/is_search DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=9c659376ce 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: is_search()
    The Daily WordPress Reference
    is_search()
    This Conditional Tag checks if search result page archive is being displayed. This is a boolean function, meaning it returns either TRUE or FALSE.
    Usage 
    <?php is_search(); ?>
    Parameters
    None.
    Return values
    (boolean)
       True on success, false on failure.
    Examples 
    <?php

if ( is_search() ) {

    // add external search form (Google, Yahoo, Live...)

}

?>
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: is_search() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Thu, 01 Nov 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: wp_remote_post()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=10967a5038 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=10967a5038 Parameters $slug (mixed) (optional) The Tag slug or an Array of slugs. Default: None Return Values Array of results including HTTP headers. print_r results of requesting a simple web page using default arguments: Array ( [headers] => Array ( [date] => Thu, 30 Sep 2010 15:16:36 GMT [server] => Apache [x-powered-by] => PHP/5.3.3 [x-server] => 10.90.6.243 [expires] => Thu, 30 Sep 2010 03:16:36 GMT [cache-control] => Array ( [0] => no-store, no-cache, must-revalidate [1] => post-check=0, pre-check=0 ) [vary] => Accept-Encoding [content-length] => 1641 [connection] => close [content-type] => application/php ) [body] => This is a website! [response] => Array ( [code] => 200 [message] => OK ) [cookies] => Array ( ) ) Examples Post data should be sent in the body as an array. Example passing post data: $response = wp_remote_post( $url, array( 'method' => 'POST', 'timeout' => 45, 'redirection' => 5, 'httpversion' => '1.0', 'blocking' => true, 'headers' => array(), 'body' => array( 'username' => 'bob', 'password' => '1234xyz' ), 'cookies' => array() ) ); if( is_wp_error( $response ) ) { echo 'Something went wrong!'; } else { echo 'Response:
    ';
      print_r( $response );
      echo '
    '; } More informations http://codex.wordpress.org/Function_API/wp_remote_post DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=10967a5038 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]>     The Daily WordPress Reference: wp_remote_post()
    The Daily WordPress Reference
    wp_remote_post()

    Retrieves a URL using the HTTP POST method, returning results in an array. Results include HTTP headers and content.

    See Function_API/wp_remote_get for using the HTTP GET method.
    Usage 
    <?php wp_remote_post( $url, $args ); ?>
    Parameters
    $url
      (string) (required) Universal Resource Locator (URL).
      Default: None
    $args
      (array) (optional) Optional. See HTTP_API#Other_Arguments for argument details.
      Default: method: POST, timeout: 5, redirection: 5, httpversion: 1.0, blocking: true, headers: array(),
      body: null, cookies: array()
    Return values

    Array of results including HTTP headers. print_r results of requesting a simple web page using default arguments:

    Array
(
    [headers] => Array
        (
            [date] => Thu, 30 Sep 2010 15:16:36 GMT
            [server] => Apache
            [x-powered-by] => PHP/5.3.3
            [x-server] => 10.90.6.243
            [expires] => Thu, 30 Sep 2010 03:16:36 GMT
            [cache-control] => Array
                (
                    [0] => no-store, no-cache, must-revalidate
                    [1] => post-check=0, pre-check=0
                )

            [vary] => Accept-Encoding
            [content-length] => 1641
            [connection] => close
            [content-type] => application/php
        )
    [body] => <html>This is a website!</html>
    [response] => Array
        (
            [code] => 200
            [message] => OK
        )

    [cookies] => Array
        (
        )

)
    Examples

    Post data should be sent in the body as an array. Example passing post data:

    $response = wp_remote_post( $url, array(
  'method' => 'POST',
  'timeout' => 45,
  'redirection' => 5,
  'httpversion' => '1.0',
  'blocking' => true,
  'headers' => array(),
  'body' => array( 'username' => 'bob',
                   'password' => '1234xyz' ),
  'cookies' => array()
  )
);

if( is_wp_error( $response ) ) {
   echo 'Something went wrong!';
} else {
   echo 'Response:<pre>';
   print_r( $response );
   echo '</pre>';
}
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: wp_remote_post() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Wed, 31 Oct 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: is_tag()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=4bb1688ccf http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=4bb1688ccf Parameters $slug (mixed) (optional) The Tag slug or an Array of slugs. Default: None Return Values (boolean) True on success, false on failure. Examples is_tag(); // When any Tag archive page is being displayed. is_tag( 'mild' ); // When the archive page for tag with the slug of 'mild' is being displayed. is_tag( array( 'sharp', 'mild', 'extreme' ) ); // Returns true when the tag archive being displayed has a slug of either "sharp", "mild", or "extreme". Note: the array ability was added at Version 2.5. More informations http://codex.wordpress.org/Function_Reference/is_tag DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=4bb1688ccf 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: is_tag()
    The Daily WordPress Reference
    is_tag()
    This Conditional Tag checks if a Tag archive page is being displayed. This is a boolean function, meaning it returns either TRUE or FALSE.
    Usage 
    <?php is_tag( $slug ); ?>
    Parameters
    $slug
       (mixed) (optional) The Tag slug or an Array of slugs.
       Default: None
    Return values
    (boolean)
       True on success, false on failure.
    Examples 
    /***************************************************
When any Tag archive page is being displayed.
***************************************************/
is_tag();

/***************************************************
When the archive page for tag with the slug of 'mild'
is being displayed.
***************************************************/
is_tag( 'mild' );

/**************************************************
Returns true when the tag archive being
displayed has a slug of either "sharp", "mild",
or "extreme".  Note: the array ability was
added at Version 2.5.
**************************************************/
is_tag( array( 'sharp', 'mild', 'extreme' ) );
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: is_tag() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Tue, 30 Oct 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: disabled()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=9b8ad53179 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=9b8ad53179 Parameters $disabled (mixed) (required) One of the values to compare. Default: None $current (mixed) (optional) The other value to compare if not just true. Default: true $echo (boolean) (optional) Whether to echo or just return the string. This function will always return the result regardless. Default: true Return Values (string) HTML attribute (disabled='disabled') or empty string. Examples /> More informations http://codex.wordpress.org/Function_Reference/disabled DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=9b8ad53179 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: disabled()
    The Daily WordPress Reference
    disabled()
    Compares two given values (for example, a saved option vs. one chosen in a form) and, if the values are the same, adds the disabled attribute to a form input field.
    Usage 
    <?php disabled( $disabled, $current, $echo ); ?>
    Parameters
    $disabled
       (mixed) (required) One of the values to compare.
       Default: None
     
    $current
       (mixed) (optional) The other
       value to compare if not just true.
       Default: true
     
    $echo
       (boolean) (optional) Whether to echo
       or just return the string. This function
       will always return the result regardless.
       Default: true
    Return values
    (string)
       The date, translated if locale specifies it.
    Examples 
    <input type="radio" name="attachments"  
  value="<?php echo $value; ?>" 
  <?php disabled( $value, false ); ?> />
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: disabled() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Mon, 29 Oct 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: date_i18n()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=5f00db6799 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=5f00db6799 Parameters $dateformatstring (string) (required) Format to display the date. Default: None $unixtimestamp (integer) (optional) Unix timestamp. Default: false $gmt (boolean) (optional) Whether to convert to GMT for time. Default: false Return Values (string) The date, translated if locale specifies it. Examples Depending on your blog settings you will see the date displayed in your local format, for example: 15. november 1976. More informations http://codex.wordpress.org/Function_Reference/date_i18n Name WordPress Theme object. ThemeURI The path to the theme's directory Description The description of the theme Author The theme's author AuthorURI The website of the theme author Version The version of the theme Template The folder name of the current theme Status If the theme is published Tags Tags used to describe the theme TextDomain The text domain used in the theme for translation purposes DomainPath Path to the theme translation files Examples Display the Current Theme's Version Name . " is version " . $my_theme->Version; ?> More informations http://codex.wordpress.org/Function_Reference/wp_get_theme DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=5f00db6799 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: date_i18n()
    The Daily WordPress Reference
    date_i18n()

    Retrieve the date in localized format, based on timestamp.

    If the locale specifies the locale month and weekday, then the locale will take over the format for the date. If it isn't, then the date format string will be used instead.

    i18n is an abbreviation for Internationalization. (There are 18 letters between the first "i" and last "n".)
    Usage 
    <?php
echo date_i18n( $dateformatstring, $unixtimestamp, $gmt ) 
?>
    Parameters
    $dateformatstring
       (string) (required) Format to display the date.
       Default: None
     
    $unixtimestamp
       (integer) (optional) Unix timestamp.
       Default: false
     
    $gmt
       (boolean) (optional) Whether to convert to GMT for time.
       Default: false
    Return values
    (string)
       The date, translated if locale specifies it.
    Examples

    Depending on your blog settings you will see the date displayed in your local format, for example: 15. november 1976.

    <?php 
echo date_i18n(get_option('date_format'),strtotime("11/15-1976"));
?>
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: date_i18n() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Sat, 27 Oct 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: wp_get_theme()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=1c008eec28 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=1c008eec28 Parameters $stylesheet (string) (Optional) Directory name for the theme. Defaults to current theme. Default: Null $theme_root (string) (Optional) Absolute path of the theme root to look in. If not specified, the value returned by get_raw_theme_root() will be used. Default: Null Return Values This function returns an instance of the WP_Theme object with the following items Name WordPress Theme object. ThemeURI The path to the theme's directory Description The description of the theme Author The theme's author AuthorURI The website of the theme author Version The version of the theme Template The folder name of the current theme Status If the theme is published Tags Tags used to describe the theme TextDomain The text domain used in the theme for translation purposes DomainPath Path to the theme translation files Examples Display the Current Theme's Version Name . " is version " . $my_theme->Version; ?> More informations http://codex.wordpress.org/Function_Reference/wp_get_theme DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=1c008eec28 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: wp_get_theme()
    The Daily WordPress Reference
    wp_get_theme()
    Gets a WP_Theme object for a theme.
    Usage 
    <?php $theme = wp_get_theme( $stylesheet, $theme_root ); ?>
    Parameters
    $stylesheet
       (string) (Optional) Directory name for the theme. Defaults to current theme.
       Default: Null
     
    $theme_root
       (string) (Optional) Absolute path of the theme root to look in. If not specified, the value returned by get_raw_theme_root() will be used.
       Default: Null
    Return values

    This function returns an instance of the WP_Theme object with the following items

    Name
       WordPress Theme object.
    ThemeURI
       The path to the theme's directory
    Description
       The description of the theme
    Author
       The theme's author
    AuthorURI
       The website of the theme author
    Version
       The version of the theme
    Template
       The folder name of the current theme
    Status
       If the theme is published
    Tags
       Tags used to describe the theme
    TextDomain
       The text domain used in the theme for translation purposes
    DomainPath
       Path to the theme translation files
    Examples

    Display the Current Theme's Version

    <?php
$my_theme = wp_get_theme();
echo $my_theme->Name . " is version " .
     $my_theme->Version;
?>
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: wp_get_theme() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Fri, 26 Oct 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: get_comments()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=d1811e5b8e http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=d1811e5b8e Default Usage '', 'ID' => '', 'karma' => '', 'number' => '', 'offset' => '', 'orderby' => '', 'order' => 'DESC', 'parent' => '', 'post_id' => '', 'post_author' => '', 'post_name' => '', 'post_parent' => '', 'post_status' => '', 'post_type' => '', 'status' => '', 'type' => '', 'user_id' => '', 'search' => '', 'count' => false ); ?> Parameters $status (string) (optional) Only return comments with this status. 'hold' - unapproved comments 'approve' - approved comments 'spam' - spam comments 'trash' - trash comments Default: None $orderby (string) (optional) Set the field used to sort comments. Default: comment_date_gmt $order (string) (optional) How to sort $orderby. Valid values: 'ASC' - Ascending (lowest to highest). 'DESC' - Descending (highest to lowest). Default: DESC $number (integer) (optional) Number of comments to return. Leave blank to return all comments. Default: unlimited $offset (integer) (optional) Offset from latest comment. You must include $number along with this. Default: 0 $post_id (integer) (optional) Only return comments for a particular post or page. Default: None $user_id (integer) (optional) Only return comments for a particular user. Default: None $count (integer) (optional) Only return the total count of comments. Default: None Return Values (Array) Comment fields Examples Show comments of a user: 1, // use user_id ); $comments = get_comments($args); foreach($comments as $comment) : echo($comment->comment_author . '
    ' . $comment->comment_content); endforeach; ?> More informations http://codex.wordpress.org/Function_Reference/get_comments DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=d1811e5b8e 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]>     The Daily WordPress Reference: get_comments()
    The Daily WordPress Reference
    get_comments()
    Retrieve a list of comments.
    Usage 
    <?php get_comments( $args ); ?>
    Default Usage 
    <?php $defaults = array(
	'author_email' => '',
	'ID' => '',
	'karma' => '',
	'number' => '',
	'offset' => '',
	'orderby' => '',
	'order' => 'DESC',
	'parent' => '',
	'post_id' => '',
	'post_author' => '',
	'post_name' => '',
	'post_parent' => '',
	'post_status' => '',
	'post_type' => '',
	'status' => '',
	'type' => '',
	'user_id' => '',
	'search' => '',
	'count' => false
); ?>
    Parameters
    $status
       (string) (optional) Only return comments with this status.
    • 'hold' - unapproved comments
    • 'approve' - approved comments
    • 'spam' - spam comments
    • 'trash' - trash comments
    Default: None
    $orderby
       (string) (optional) Set the field
       used to sort comments.
       Default: comment_date_gmt
     
    $order
       (string) (optional) How to sort $orderby. Valid values:
    • 'ASC' - Ascending (lowest to highest).
    • 'DESC' - Descending (highest to lowest).
    Default: DESC
    $number
       (integer) (optional) Number of comments to
       return. Leave blank to return all comments.
       Default: unlimited
     
    $offset
       (integer) (optional) Offset from latest comment.
       You must include $number along with this.
       Default: 0
     
    $post_id
       (integer) (optional) Only return comments
       for a particular post or page.
       Default: None
     
    $user_id
       (integer) (optional) Only return
       comments for a particular user.
       Default: None
     
    $count
       (integer) (optional) Only return the
       total count of comments.
       Default: None
    Return values
    (Array) 
       Comment fields
    Examples

    Show comments of a user:

    <?php
$args = array(
	'user_id' => 1, // use user_id
);
$comments = get_comments($args);
foreach($comments as $comment) :
	echo($comment->comment_author .
       '<br />' . $comment->comment_content);
endforeach;

?>
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: get_comments() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Thu, 25 Oct 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: get_stylesheet_directory_uri()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=1d4d7b2e46 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=1d4d7b2e46 Output the URI Parameters None. Return Values uri (string) Stylesheet directory URI. Examples Image (HTML) More informations http://codex.wordpress.org/Function_Reference/get_stylesheet_directory_uri DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=1d4d7b2e46 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: get_stylesheet_directory_uri()
    The Daily WordPress Reference
    get_stylesheet_directory_uri()

    Retrieve stylesheet directory URI for the current theme/child theme. Checks for SSL.

    Note: Does not contain a trailing slash.

    Note that this returns a properly-formed URI; in other words, it will be a web-address (starting with http:// or https:// for SSL). As such, it is most appropriately used for links, referencing additional stylesheets, or probably most commonly, images.

    In the event a child theme is being used, this function will return the child's theme directory URI. Use get_template_directory_uri() instead if you want the parent directory.

    If you want to include a local file in PHP, use get_stylesheet_directory() instead.
    Usage

    Use the URI

    <?php get_stylesheet_directory_uri(); ?>

    Output the URI

    <?php echo get_stylesheet_directory_uri(); ?>
    Parameters
    None.
    Return values
    uri (string)
       Stylesheet directory URI.
    Examples

    Image (HTML)

    <img src="<?php
echo get_stylesheet_directory_uri() 
?>/images/logo.png" alt="" title="" width="" height="" />
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: get_stylesheet_directory_uri() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Wed, 24 Oct 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: get_header()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=4893dbda0f http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=4893dbda0f Parameters $name (string) (optional) Calls for header-name.php. Default: None Return Values None. Examples Multi headers Different header for different pages. More informations http://codex.wordpress.org/Function_Reference/get_header DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=4893dbda0f 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: get_header()
    The Daily WordPress Reference
    get_header()

    Includes the header.php template file from your current theme's directory. if a name is specified then a specialised header header-{name}.php will be included.

    If the theme contains no header.php file then the header from the default theme wp-includes/theme-compat/header.php will be included.
    Usage 
    <?php get_header( $name ); ?>
    Parameters
    $name
       (string) (optional) Calls for header-name.php.
       Default: None
    Return values
    The ID of the post if the post is successfully added to the database. On failure, it returns 0 if $wp_error is set to false, or a WP_Error object if $wp_error is set to true.
    Examples

    Multi headers

    Different header for different pages.

    <?php
if ( is_home() ) :
  get_header('home');
elseif ( is_404() ) :
  get_header('404');
else :
  get_header();
endif;
?>
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: get_header() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Tue, 23 Oct 2012 12:00:00 +0000     <![CDATA[The Daily WordPress Reference: wp_insert_post()]]> http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=c248003a99 http://us4.campaign-archive.com/?u=427153c482114d70024e1dc1a&id=c248003a99 Parameters $post (array) (required) An array representing the elements that make up a post. There is a one-to-one relationship between these elements and the names of columns in the wp_posts table in the database. Default: None The contents of the post array can depend on how much (or little) you want to trust the defaults. Here is a list with a short description of all the keys you can set for a post: $post = array( 'ID' => [ ] //Are you updating an existing post? 'menu_order' => [ ] //If new post is a page, it sets the order in which it should appear in the tabs. 'comment_status' => [ 'closed' | 'open' ] // 'closed' means no comments. 'ping_status' => [ 'closed' | 'open' ] // 'closed' means pingbacks or trackbacks turned off 'pinged' => [ ? ] //? 'post_author' => [ ] //The user ID number of the author. 'post_category' => [ array(, <...>) ] //post_category no longer exists, try wp_set_post_terms() for setting a post's categories 'post_content' => [ ] //The full text of the post. 'post_date' => [ Y-m-d H:i:s ] //The time post was made. 'post_date_gmt' => [ Y-m-d H:i:s ] //The time post was made, in GMT. 'post_excerpt' => [ ] //For all your post excerpt needs. 'post_name' => [ ] // The name (slug) for your post 'post_parent' => [ ] //Sets the parent of the new post. 'post_password' => [ ? ] //password for post? 'post_status' => [ 'draft' | 'publish' | 'pending'| 'future' | 'private' | custom registered status ] //Set the status of the new post. 'post_title' => [ ] //The title of your post. 'post_type' => [ 'post' | 'page' | 'link' | 'nav_menu_item' | custom post type ] //You may want to insert a regular post, page, link, a menu item or some custom post type 'tags_input' => [ ', , <...>' ] //For tags. 'to_ping' => [ ? ] //? 'tax_input' => [ array( 'taxonomy_name' => array( 'term', 'term2', 'term3' ) ) ] // support for custom taxonomies. ); $wp_error (bool) (optional) Allow return of WP_Error object on failure Default: false Return Values The ID of the post if the post is successfully added to the database. On failure, it returns 0 if $wp_error is set to false, or a WP_Error object if $wp_error is set to true. Examples Before calling wp_insert_post() it is necessary to create an array to pass the necessary elements that make up a post. The wp_insert_post() will fill out a default list of these but the user is required to provide the title and content otherwise the database write will fail. The user can provide more elements than are listed here by simply defining new keys in the database. The keys should match the names of the columns in the wp_posts table in the database. // Create post object $my_post = array( 'post_title' => 'My post', 'post_content' => 'This is my post.', 'post_status' => 'publish', 'post_author' => 1, 'post_category' => array(8,39) ); // Insert the post into the database wp_insert_post( $my_post ); More informations http://codex.wordpress.org/Function_Reference/wp_insert_post DailyWordpressReference is not affiliated with WordPress in any way. __________________________________________________________________ Links: [1]Follow the Daily WordPress Reference on Twitter [2]unsubscribe from this list | [3]update subscription preferences Links: 1. Twitter Account not yet Authorized 2. http://dailydocumentation.us4.list-manage.com/unsubscribe?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]&c=c248003a99 3. http://dailydocumentation.us4.list-manage.com/profile?u=427153c482114d70024e1dc1a&id=60aff5b9cd&e=[UNIQID]]]> The Daily WordPress Reference: wp_insert_post()
    The Daily WordPress Reference
    wp_insert_post()
    This function inserts posts (and pages) in the database. It sanitizes variables, does some checks, fills in missing variables like date/time, etc. It takes an object as its argument and returns the post ID of the created post (or 0 if there is an error).
    Usage 
    <?php wp_insert_post( $post, $wp_error ); ?>
    Parameters
    $post
       (array) (required) An array representing the elements that
       make up a post. There is a one-to-one relationship between
       these elements and the names of columns in the wp_posts
       table in the database.
       Default: None
     
    $wp_error
       (bool) (optional) Allow return of WP_Error object on failure
       Default: false

    The contents of the post array can depend on how much (or little) you want to trust the defaults. Here is a list with a short description of all the keys you can set for a post:

    $post = array(
  // Are you updating an existing post?
  'ID'             => [ <post id> ] 
  // if new post is a page, it sets the
  // order in wich it should appear in the tabs.
  'menu_order'     => [ <order> ] 
  // 'closed' means no comments.
  'comment_status' => [ 'closed' | 'open' ]
  // 'closed' means pingbacks or trakbacks turned off
  'ping_status'    => [ 'closed' | 'open' ]
  'pinged'         => [ ? ] //?
  // The user ID number of the author.
  'post_author'    => [ <user ID> ] 
  // post_category no longer exists, try wp_set_post_terms()
  // for setting a post's categories
  'post_category'  => [ array(<category id>, <...>) ]
  // The full text of the post
  'post_content'   => [ <the text of the post> ]
  // The time post was made.
  'post_date'      => [ Y-m-d H:i:s ]
  // The time post was made, in GMT.
  'post_date_gmt'  => [ Y-m-d H:i:s ]
  // For all your post excerpt needs
  'post_excerpt'   => [ <an excerpt> ]
  // The name (slug) for your post
  'post_name'      => [ <the name> ]
  // Sets the parent of the new post.
  'post_parent'    => [ <post ID> ]
  'post_password'  => [ ? ] //password for post?
  // Set the status of the new post.
  'post_status'    => [ 'draft' | 'publish' 
    | 'pending'| 'future' | 'private' | custom registered status ] 
  'post_title'     => [ <the title> ] //The title of your post.
  // You may want to insert a regular post, page,
  // link, a menu item or some custom post type
  'post_type'      => [ 'post' | 'page' 
    | 'link' | 'nav_menu_item' | custom post type ] 
  'tags_input'     => [ '<tag>, <tag>, <...>' ] //For tags.
  'to_ping'        => [ ? ] //?
  // support for custom taxonomies. 
  'tax_input'      => [ array( 
    'taxonomy_name' => array( 'term', 'term2', 'term3' ) ) ] 
);
    Return values
    The ID of the post if the post is successfully added to the database. On failure, it returns 0 if $wp_error is set to false, or a WP_Error object if $wp_error is set to true.
    Examples

    Before calling wp_insert_post() it is necessary to create an array to pass the necessary elements that make up a post. The wp_insert_post() will fill out a default list of these but the user is required to provide the title and content otherwise the database write will fail.

    The user can provide more elements than are listed here by simply defining new keys in the database. The keys should match the names of the columns in the wp_posts table in the database.

    // Create post object
$my_post = array(
  'post_title'    => 'My post',
  'post_content'  => 'This is my post.',
  'post_status'   => 'publish',
  'post_author'   => 1,
  'post_category' => array(8,39)
);

// Insert the post into the database
wp_insert_post( $my_post );
    More information

    Liked this function?
    You might also like these books:
    		 Share it:
    share on Twitter Like The Daily WordPress Reference: wp_insert_post() on Facebook
     Or Donate to the project:
    Donata via Paypal
    (Why Donate?)

    ]]>     Mon, 22 Oct 2012 12:00:00 +0000