* @param int|WP_Comment $comment_id Comment ID or WP_Comment object.

[1500] Fix | Delete

* @param bool $force_delete Whether to bypass Trash and force deletion. Default false.

[1501] Fix | Delete

* @return bool True on success, false on failure.

[1502] Fix | Delete

*/

[1503] Fix | Delete

function wp_delete_comment( $comment_id, $force_delete = false ) {

[1504] Fix | Delete

global $wpdb;

[1505] Fix | Delete

[1506] Fix | Delete

$comment = get_comment( $comment_id );

[1507] Fix | Delete

if ( ! $comment ) {

[1508] Fix | Delete

return false;

[1509] Fix | Delete

}

[1510] Fix | Delete

[1511] Fix | Delete

if ( ! $force_delete && EMPTY_TRASH_DAYS && ! in_array( wp_get_comment_status( $comment ), array( 'trash', 'spam' ), true ) ) {

[1512] Fix | Delete

return wp_trash_comment( $comment_id );

[1513] Fix | Delete

}

[1514] Fix | Delete

[1515] Fix | Delete

/**

[1516] Fix | Delete

* Fires immediately before a comment is deleted from the database.

[1517] Fix | Delete

*

[1518] Fix | Delete

* @since 1.2.0

[1519] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1520] Fix | Delete

*

[1521] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1522] Fix | Delete

* @param WP_Comment $comment The comment to be deleted.

[1523] Fix | Delete

*/

[1524] Fix | Delete

do_action( 'delete_comment', $comment->comment_ID, $comment );

[1525] Fix | Delete

[1526] Fix | Delete

// Move children up a level.

[1527] Fix | Delete

$children = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_parent = %d", $comment->comment_ID ) );

[1528] Fix | Delete

if ( ! empty( $children ) ) {

[1529] Fix | Delete

$wpdb->update( $wpdb->comments, array( 'comment_parent' => $comment->comment_parent ), array( 'comment_parent' => $comment->comment_ID ) );

[1530] Fix | Delete

clean_comment_cache( $children );

[1531] Fix | Delete

}

[1532] Fix | Delete

[1533] Fix | Delete

// Delete metadata.

[1534] Fix | Delete

$meta_ids = $wpdb->get_col( $wpdb->prepare( "SELECT meta_id FROM $wpdb->commentmeta WHERE comment_id = %d", $comment->comment_ID ) );

[1535] Fix | Delete

foreach ( $meta_ids as $mid ) {

[1536] Fix | Delete

delete_metadata_by_mid( 'comment', $mid );

[1537] Fix | Delete

}

[1538] Fix | Delete

[1539] Fix | Delete

if ( ! $wpdb->delete( $wpdb->comments, array( 'comment_ID' => $comment->comment_ID ) ) ) {

[1540] Fix | Delete

return false;

[1541] Fix | Delete

}

[1542] Fix | Delete

[1543] Fix | Delete

/**

[1544] Fix | Delete

* Fires immediately after a comment is deleted from the database.

[1545] Fix | Delete

*

[1546] Fix | Delete

* @since 2.9.0

[1547] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1548] Fix | Delete

*

[1549] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1550] Fix | Delete

* @param WP_Comment $comment The deleted comment.

[1551] Fix | Delete

*/

[1552] Fix | Delete

do_action( 'deleted_comment', $comment->comment_ID, $comment );

[1553] Fix | Delete

[1554] Fix | Delete

$post_id = $comment->comment_post_ID;

[1555] Fix | Delete

if ( $post_id && '1' === $comment->comment_approved ) {

[1556] Fix | Delete

wp_update_comment_count( $post_id );

[1557] Fix | Delete

}

[1558] Fix | Delete

[1559] Fix | Delete

clean_comment_cache( $comment->comment_ID );

[1560] Fix | Delete

[1561] Fix | Delete

/** This action is documented in wp-includes/comment.php */

[1562] Fix | Delete

do_action( 'wp_set_comment_status', $comment->comment_ID, 'delete' );

[1563] Fix | Delete

[1564] Fix | Delete

wp_transition_comment_status( 'delete', $comment->comment_approved, $comment );

[1565] Fix | Delete

[1566] Fix | Delete

return true;

[1567] Fix | Delete

}

[1568] Fix | Delete

[1569] Fix | Delete

/**

[1570] Fix | Delete

* Moves a comment to the Trash

[1571] Fix | Delete

*

[1572] Fix | Delete

* If Trash is disabled, comment is permanently deleted.

[1573] Fix | Delete

*

[1574] Fix | Delete

* @since 2.9.0

[1575] Fix | Delete

* @since 6.9.0 Any child notes are deleted when deleting a note.

[1576] Fix | Delete

*

[1577] Fix | Delete

* @param int|WP_Comment $comment_id Comment ID or WP_Comment object.

[1578] Fix | Delete

* @return bool True on success, false on failure.

[1579] Fix | Delete

*/

[1580] Fix | Delete

function wp_trash_comment( $comment_id ) {

[1581] Fix | Delete

if ( ! EMPTY_TRASH_DAYS ) {

[1582] Fix | Delete

$comment = get_comment( $comment_id );

[1583] Fix | Delete

$success = wp_delete_comment( $comment_id, true );

[1584] Fix | Delete

[1585] Fix | Delete

if ( ! $success ) {

[1586] Fix | Delete

return false;

[1587] Fix | Delete

}

[1588] Fix | Delete

[1589] Fix | Delete

// Also delete children of top level 'note' type comments.

[1590] Fix | Delete

if ( $comment && 'note' === $comment->comment_type && 0 === (int) $comment->comment_parent ) {

[1591] Fix | Delete

$children = $comment->get_children(

[1592] Fix | Delete

array(

[1593] Fix | Delete

'fields' => 'ids',

[1594] Fix | Delete

'status' => 'all',

[1595] Fix | Delete

'type' => 'note',

[1596] Fix | Delete

)

[1597] Fix | Delete

);

[1598] Fix | Delete

[1599] Fix | Delete

foreach ( $children as $child_id ) {

[1600] Fix | Delete

if ( ! wp_delete_comment( $child_id, true ) ) {

[1601] Fix | Delete

$success = false;

[1602] Fix | Delete

}

[1603] Fix | Delete

}

[1604] Fix | Delete

}

[1605] Fix | Delete

[1606] Fix | Delete

return $success;

[1607] Fix | Delete

}

[1608] Fix | Delete

[1609] Fix | Delete

$comment = get_comment( $comment_id );

[1610] Fix | Delete

if ( ! $comment ) {

[1611] Fix | Delete

return false;

[1612] Fix | Delete

}

[1613] Fix | Delete

[1614] Fix | Delete

/**

[1615] Fix | Delete

* Fires immediately before a comment is sent to the Trash.

[1616] Fix | Delete

*

[1617] Fix | Delete

* @since 2.9.0

[1618] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1619] Fix | Delete

*

[1620] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1621] Fix | Delete

* @param WP_Comment $comment The comment to be trashed.

[1622] Fix | Delete

*/

[1623] Fix | Delete

do_action( 'trash_comment', $comment->comment_ID, $comment );

[1624] Fix | Delete

[1625] Fix | Delete

if ( wp_set_comment_status( $comment, 'trash' ) ) {

[1626] Fix | Delete

delete_comment_meta( $comment->comment_ID, '_wp_trash_meta_status' );

[1627] Fix | Delete

delete_comment_meta( $comment->comment_ID, '_wp_trash_meta_time' );

[1628] Fix | Delete

add_comment_meta( $comment->comment_ID, '_wp_trash_meta_status', $comment->comment_approved );

[1629] Fix | Delete

add_comment_meta( $comment->comment_ID, '_wp_trash_meta_time', time() );

[1630] Fix | Delete

[1631] Fix | Delete

/**

[1632] Fix | Delete

* Fires immediately after a comment is sent to Trash.

[1633] Fix | Delete

*

[1634] Fix | Delete

* @since 2.9.0

[1635] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1636] Fix | Delete

*

[1637] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1638] Fix | Delete

* @param WP_Comment $comment The trashed comment.

[1639] Fix | Delete

*/

[1640] Fix | Delete

do_action( 'trashed_comment', $comment->comment_ID, $comment );

[1641] Fix | Delete

[1642] Fix | Delete

// For top level 'note' type comments, also trash children.

[1643] Fix | Delete

if ( 'note' === $comment->comment_type && 0 === (int) $comment->comment_parent ) {

[1644] Fix | Delete

$children = $comment->get_children(

[1645] Fix | Delete

array(

[1646] Fix | Delete

'fields' => 'ids',

[1647] Fix | Delete

'status' => 'all',

[1648] Fix | Delete

'type' => 'note',

[1649] Fix | Delete

)

[1650] Fix | Delete

);

[1651] Fix | Delete

[1652] Fix | Delete

$success = true;

[1653] Fix | Delete

foreach ( $children as $child_id ) {

[1654] Fix | Delete

if ( ! wp_trash_comment( $child_id ) ) {

[1655] Fix | Delete

$success = false;

[1656] Fix | Delete

}

[1657] Fix | Delete

}

[1658] Fix | Delete

return $success;

[1659] Fix | Delete

}

[1660] Fix | Delete

[1661] Fix | Delete

return true;

[1662] Fix | Delete

}

[1663] Fix | Delete

[1664] Fix | Delete

return false;

[1665] Fix | Delete

}

[1666] Fix | Delete

[1667] Fix | Delete

/**

[1668] Fix | Delete

* Removes a comment from the Trash

[1669] Fix | Delete

*

[1670] Fix | Delete

* @since 2.9.0

[1671] Fix | Delete

*

[1672] Fix | Delete

* @param int|WP_Comment $comment_id Comment ID or WP_Comment object.

[1673] Fix | Delete

* @return bool True on success, false on failure.

[1674] Fix | Delete

*/

[1675] Fix | Delete

function wp_untrash_comment( $comment_id ) {

[1676] Fix | Delete

$comment = get_comment( $comment_id );

[1677] Fix | Delete

if ( ! $comment ) {

[1678] Fix | Delete

return false;

[1679] Fix | Delete

}

[1680] Fix | Delete

[1681] Fix | Delete

/**

[1682] Fix | Delete

* Fires immediately before a comment is restored from the Trash.

[1683] Fix | Delete

*

[1684] Fix | Delete

* @since 2.9.0

[1685] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1686] Fix | Delete

*

[1687] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1688] Fix | Delete

* @param WP_Comment $comment The comment to be untrashed.

[1689] Fix | Delete

*/

[1690] Fix | Delete

do_action( 'untrash_comment', $comment->comment_ID, $comment );

[1691] Fix | Delete

[1692] Fix | Delete

$status = (string) get_comment_meta( $comment->comment_ID, '_wp_trash_meta_status', true );

[1693] Fix | Delete

if ( empty( $status ) ) {

[1694] Fix | Delete

$status = '0';

[1695] Fix | Delete

}

[1696] Fix | Delete

[1697] Fix | Delete

if ( wp_set_comment_status( $comment, $status ) ) {

[1698] Fix | Delete

delete_comment_meta( $comment->comment_ID, '_wp_trash_meta_time' );

[1699] Fix | Delete

delete_comment_meta( $comment->comment_ID, '_wp_trash_meta_status' );

[1700] Fix | Delete

[1701] Fix | Delete

/**

[1702] Fix | Delete

* Fires immediately after a comment is restored from the Trash.

[1703] Fix | Delete

*

[1704] Fix | Delete

* @since 2.9.0

[1705] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1706] Fix | Delete

*

[1707] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1708] Fix | Delete

* @param WP_Comment $comment The untrashed comment.

[1709] Fix | Delete

*/

[1710] Fix | Delete

do_action( 'untrashed_comment', $comment->comment_ID, $comment );

[1711] Fix | Delete

[1712] Fix | Delete

return true;

[1713] Fix | Delete

}

[1714] Fix | Delete

[1715] Fix | Delete

return false;

[1716] Fix | Delete

}

[1717] Fix | Delete

[1718] Fix | Delete

/**

[1719] Fix | Delete

* Marks a comment as Spam.

[1720] Fix | Delete

*

[1721] Fix | Delete

* @since 2.9.0

[1722] Fix | Delete

*

[1723] Fix | Delete

* @param int|WP_Comment $comment_id Comment ID or WP_Comment object.

[1724] Fix | Delete

* @return bool True on success, false on failure.

[1725] Fix | Delete

*/

[1726] Fix | Delete

function wp_spam_comment( $comment_id ) {

[1727] Fix | Delete

$comment = get_comment( $comment_id );

[1728] Fix | Delete

if ( ! $comment ) {

[1729] Fix | Delete

return false;

[1730] Fix | Delete

}

[1731] Fix | Delete

[1732] Fix | Delete

/**

[1733] Fix | Delete

* Fires immediately before a comment is marked as Spam.

[1734] Fix | Delete

*

[1735] Fix | Delete

* @since 2.9.0

[1736] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1737] Fix | Delete

*

[1738] Fix | Delete

* @param int $comment_id The comment ID.

[1739] Fix | Delete

* @param WP_Comment $comment The comment to be marked as spam.

[1740] Fix | Delete

*/

[1741] Fix | Delete

do_action( 'spam_comment', $comment->comment_ID, $comment );

[1742] Fix | Delete

[1743] Fix | Delete

if ( wp_set_comment_status( $comment, 'spam' ) ) {

[1744] Fix | Delete

delete_comment_meta( $comment->comment_ID, '_wp_trash_meta_status' );

[1745] Fix | Delete

delete_comment_meta( $comment->comment_ID, '_wp_trash_meta_time' );

[1746] Fix | Delete

add_comment_meta( $comment->comment_ID, '_wp_trash_meta_status', $comment->comment_approved );

[1747] Fix | Delete

add_comment_meta( $comment->comment_ID, '_wp_trash_meta_time', time() );

[1748] Fix | Delete

[1749] Fix | Delete

/**

[1750] Fix | Delete

* Fires immediately after a comment is marked as Spam.

[1751] Fix | Delete

*

[1752] Fix | Delete

* @since 2.9.0

[1753] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1754] Fix | Delete

*

[1755] Fix | Delete

* @param int $comment_id The comment ID.

[1756] Fix | Delete

* @param WP_Comment $comment The comment marked as spam.

[1757] Fix | Delete

*/

[1758] Fix | Delete

do_action( 'spammed_comment', $comment->comment_ID, $comment );

[1759] Fix | Delete

[1760] Fix | Delete

return true;

[1761] Fix | Delete

}

[1762] Fix | Delete

[1763] Fix | Delete

return false;

[1764] Fix | Delete

}

[1765] Fix | Delete

[1766] Fix | Delete

/**

[1767] Fix | Delete

* Removes a comment from the Spam.

[1768] Fix | Delete

*

[1769] Fix | Delete

* @since 2.9.0

[1770] Fix | Delete

*

[1771] Fix | Delete

* @param int|WP_Comment $comment_id Comment ID or WP_Comment object.

[1772] Fix | Delete

* @return bool True on success, false on failure.

[1773] Fix | Delete

*/

[1774] Fix | Delete

function wp_unspam_comment( $comment_id ) {

[1775] Fix | Delete

$comment = get_comment( $comment_id );

[1776] Fix | Delete

if ( ! $comment ) {

[1777] Fix | Delete

return false;

[1778] Fix | Delete

}

[1779] Fix | Delete

[1780] Fix | Delete

/**

[1781] Fix | Delete

* Fires immediately before a comment is unmarked as Spam.

[1782] Fix | Delete

*

[1783] Fix | Delete

* @since 2.9.0

[1784] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1785] Fix | Delete

*

[1786] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1787] Fix | Delete

* @param WP_Comment $comment The comment to be unmarked as spam.

[1788] Fix | Delete

*/

[1789] Fix | Delete

do_action( 'unspam_comment', $comment->comment_ID, $comment );

[1790] Fix | Delete

[1791] Fix | Delete

$status = (string) get_comment_meta( $comment->comment_ID, '_wp_trash_meta_status', true );

[1792] Fix | Delete

if ( empty( $status ) ) {

[1793] Fix | Delete

$status = '0';

[1794] Fix | Delete

}

[1795] Fix | Delete

[1796] Fix | Delete

if ( wp_set_comment_status( $comment, $status ) ) {

[1797] Fix | Delete

delete_comment_meta( $comment->comment_ID, '_wp_trash_meta_status' );

[1798] Fix | Delete

delete_comment_meta( $comment->comment_ID, '_wp_trash_meta_time' );

[1799] Fix | Delete

[1800] Fix | Delete

/**

[1801] Fix | Delete

* Fires immediately after a comment is unmarked as Spam.

[1802] Fix | Delete

*

[1803] Fix | Delete

* @since 2.9.0

[1804] Fix | Delete

* @since 4.9.0 Added the `$comment` parameter.

[1805] Fix | Delete

*

[1806] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1807] Fix | Delete

* @param WP_Comment $comment The comment unmarked as spam.

[1808] Fix | Delete

*/

[1809] Fix | Delete

do_action( 'unspammed_comment', $comment->comment_ID, $comment );

[1810] Fix | Delete

[1811] Fix | Delete

return true;

[1812] Fix | Delete

}

[1813] Fix | Delete

[1814] Fix | Delete

return false;

[1815] Fix | Delete

}

[1816] Fix | Delete

[1817] Fix | Delete

/**

[1818] Fix | Delete

* Retrieves the status of a comment by comment ID.

[1819] Fix | Delete

*

[1820] Fix | Delete

* @since 1.0.0

[1821] Fix | Delete

*

[1822] Fix | Delete

* @param int|WP_Comment $comment_id Comment ID or WP_Comment object

[1823] Fix | Delete

* @return string|false Status might be 'trash', 'approved', 'unapproved', 'spam'. False on failure.

[1824] Fix | Delete

*/

[1825] Fix | Delete

function wp_get_comment_status( $comment_id ) {

[1826] Fix | Delete

$comment = get_comment( $comment_id );

[1827] Fix | Delete

if ( ! $comment ) {

[1828] Fix | Delete

return false;

[1829] Fix | Delete

}

[1830] Fix | Delete

[1831] Fix | Delete

$approved = $comment->comment_approved;

[1832] Fix | Delete

[1833] Fix | Delete

if ( null === $approved ) {

[1834] Fix | Delete

return false;

[1835] Fix | Delete

} elseif ( '1' === $approved ) {

[1836] Fix | Delete

return 'approved';

[1837] Fix | Delete

} elseif ( '0' === $approved ) {

[1838] Fix | Delete

return 'unapproved';

[1839] Fix | Delete

} elseif ( 'spam' === $approved ) {

[1840] Fix | Delete

return 'spam';

[1841] Fix | Delete

} elseif ( 'trash' === $approved ) {

[1842] Fix | Delete

return 'trash';

[1843] Fix | Delete

} else {

[1844] Fix | Delete

return false;

[1845] Fix | Delete

}

[1846] Fix | Delete

}

[1847] Fix | Delete

[1848] Fix | Delete

/**

[1849] Fix | Delete

* Calls hooks for when a comment status transition occurs.

[1850] Fix | Delete

*

[1851] Fix | Delete

* Calls hooks for comment status transitions. If the new comment status is not the same

[1852] Fix | Delete

* as the previous comment status, then two hooks will be ran, the first is

[1853] Fix | Delete

* {@see 'transition_comment_status'} with new status, old status, and comment data.

[1854] Fix | Delete

* The next action called is {@see 'comment_$old_status_to_$new_status'}. It has

[1855] Fix | Delete

* the comment data.

[1856] Fix | Delete

*

[1857] Fix | Delete

* The final action will run whether or not the comment statuses are the same.

[1858] Fix | Delete

* The action is named {@see 'comment_$new_status_$comment->comment_type'}.

[1859] Fix | Delete

*

[1860] Fix | Delete

* @since 2.7.0

[1861] Fix | Delete

*

[1862] Fix | Delete

* @param string $new_status New comment status.

[1863] Fix | Delete

* @param string $old_status Previous comment status.

[1864] Fix | Delete

* @param WP_Comment $comment Comment object.

[1865] Fix | Delete

*/

[1866] Fix | Delete

function wp_transition_comment_status( $new_status, $old_status, $comment ) {

[1867] Fix | Delete

/*

[1868] Fix | Delete

* Translate raw statuses to human-readable formats for the hooks.

[1869] Fix | Delete

* This is not a complete list of comment status, it's only the ones

[1870] Fix | Delete

* that need to be renamed.

[1871] Fix | Delete

*/

[1872] Fix | Delete

$comment_statuses = array(

[1873] Fix | Delete

0 => 'unapproved',

[1874] Fix | Delete

'hold' => 'unapproved', // wp_set_comment_status() uses "hold".

[1875] Fix | Delete

1 => 'approved',

[1876] Fix | Delete

'approve' => 'approved', // wp_set_comment_status() uses "approve".

[1877] Fix | Delete

);

[1878] Fix | Delete

if ( isset( $comment_statuses[ $new_status ] ) ) {

[1879] Fix | Delete

$new_status = $comment_statuses[ $new_status ];

[1880] Fix | Delete

}

[1881] Fix | Delete

if ( isset( $comment_statuses[ $old_status ] ) ) {

[1882] Fix | Delete

$old_status = $comment_statuses[ $old_status ];

[1883] Fix | Delete

}

[1884] Fix | Delete

[1885] Fix | Delete

// Call the hooks.

[1886] Fix | Delete

if ( $new_status !== $old_status ) {

[1887] Fix | Delete

/**

[1888] Fix | Delete

* Fires when the comment status is in transition.

[1889] Fix | Delete

*

[1890] Fix | Delete

* @since 2.7.0

[1891] Fix | Delete

*

[1892] Fix | Delete

* @param string $new_status The new comment status.

[1893] Fix | Delete

* @param string $old_status The old comment status.

[1894] Fix | Delete

* @param WP_Comment $comment Comment object.

[1895] Fix | Delete

*/

[1896] Fix | Delete

do_action( 'transition_comment_status', $new_status, $old_status, $comment );

[1897] Fix | Delete

[1898] Fix | Delete

/**

[1899] Fix | Delete

* Fires when the comment status is in transition from one specific status to another.

[1900] Fix | Delete

*

[1901] Fix | Delete

* The dynamic portions of the hook name, `$old_status`, and `$new_status`,

[1902] Fix | Delete

* refer to the old and new comment statuses, respectively.

[1903] Fix | Delete

*

[1904] Fix | Delete

* Possible hook names include:

[1905] Fix | Delete

*

[1906] Fix | Delete

* - `comment_unapproved_to_approved`

[1907] Fix | Delete

* - `comment_spam_to_approved`

[1908] Fix | Delete

* - `comment_approved_to_unapproved`

[1909] Fix | Delete

* - `comment_spam_to_unapproved`

[1910] Fix | Delete

* - `comment_unapproved_to_spam`

[1911] Fix | Delete

* - `comment_approved_to_spam`

[1912] Fix | Delete

*

[1913] Fix | Delete

* @since 2.7.0

[1914] Fix | Delete

*

[1915] Fix | Delete

* @param WP_Comment $comment Comment object.

[1916] Fix | Delete

*/

[1917] Fix | Delete

do_action( "comment_{$old_status}_to_{$new_status}", $comment );

[1918] Fix | Delete

}

[1919] Fix | Delete

/**

[1920] Fix | Delete

* Fires when the status of a specific comment type is in transition.

[1921] Fix | Delete

*

[1922] Fix | Delete

* The dynamic portions of the hook name, `$new_status`, and `$comment->comment_type`,

[1923] Fix | Delete

* refer to the new comment status, and the type of comment, respectively.

[1924] Fix | Delete

*

[1925] Fix | Delete

* Typical comment types include 'comment', 'pingback', or 'trackback'.

[1926] Fix | Delete

*

[1927] Fix | Delete

* Possible hook names include:

[1928] Fix | Delete

*

[1929] Fix | Delete

* - `comment_approved_comment`

[1930] Fix | Delete

* - `comment_approved_pingback`

[1931] Fix | Delete

* - `comment_approved_trackback`

[1932] Fix | Delete

* - `comment_unapproved_comment`

[1933] Fix | Delete

* - `comment_unapproved_pingback`

[1934] Fix | Delete

* - `comment_unapproved_trackback`

[1935] Fix | Delete

* - `comment_spam_comment`

[1936] Fix | Delete

* - `comment_spam_pingback`

[1937] Fix | Delete

* - `comment_spam_trackback`

[1938] Fix | Delete

*

[1939] Fix | Delete

* @since 2.7.0

[1940] Fix | Delete

*

[1941] Fix | Delete

* @param string $comment_id The comment ID as a numeric string.

[1942] Fix | Delete

* @param WP_Comment $comment Comment object.

[1943] Fix | Delete

*/

[1944] Fix | Delete

do_action( "comment_{$new_status}_{$comment->comment_type}", $comment->comment_ID, $comment );

[1945] Fix | Delete

}

[1946] Fix | Delete

[1947] Fix | Delete

/**

[1948] Fix | Delete

* Clears the lastcommentmodified cached value when a comment status is changed.

[1949] Fix | Delete

*

[1950] Fix | Delete

* Deletes the lastcommentmodified cache key when a comment enters or leaves

[1951] Fix | Delete

* 'approved' status.

[1952] Fix | Delete

*

[1953] Fix | Delete

* @since 4.7.0

[1954] Fix | Delete

* @access private

[1955] Fix | Delete

*

[1956] Fix | Delete

* @param string $new_status The new comment status.

[1957] Fix | Delete

* @param string $old_status The old comment status.

[1958] Fix | Delete

*/

[1959] Fix | Delete

function _clear_modified_cache_on_transition_comment_status( $new_status, $old_status ) {

[1960] Fix | Delete

if ( 'approved' === $new_status || 'approved' === $old_status ) {

[1961] Fix | Delete

$data = array();

[1962] Fix | Delete

foreach ( array( 'server', 'gmt', 'blog' ) as $timezone ) {

[1963] Fix | Delete

$data[] = "lastcommentmodified:$timezone";

[1964] Fix | Delete

}

[1965] Fix | Delete

wp_cache_delete_multiple( $data, 'timeinfo' );

[1966] Fix | Delete

}

[1967] Fix | Delete

}

[1968] Fix | Delete

[1969] Fix | Delete

/**

[1970] Fix | Delete

* Gets current commenter's name, email, and URL.

[1971] Fix | Delete

*

[1972] Fix | Delete

* Expects cookies content to already be sanitized. User of this function might

[1973] Fix | Delete

* wish to recheck the returned array for validity.

[1974] Fix | Delete

*

[1975] Fix | Delete

* @see sanitize_comment_cookies() Use to sanitize cookies

[1976] Fix | Delete

*

[1977] Fix | Delete

* @since 2.0.4

[1978] Fix | Delete

*

[1979] Fix | Delete

* @return array {

[1980] Fix | Delete

* An array of current commenter variables.

[1981] Fix | Delete

*

[1982] Fix | Delete

* @type string $comment_author The name of the current commenter, or an empty string.

[1983] Fix | Delete

* @type string $comment_author_email The email address of the current commenter, or an empty string.

[1984] Fix | Delete

* @type string $comment_author_url The URL address of the current commenter, or an empty string.

[1985] Fix | Delete

* }

[1986] Fix | Delete

*/

[1987] Fix | Delete

function wp_get_current_commenter() {

[1988] Fix | Delete

// Cookies should already be sanitized.

[1989] Fix | Delete

[1990] Fix | Delete

$comment_author = '';

[1991] Fix | Delete

if ( isset( $_COOKIE[ 'comment_author_' . COOKIEHASH ] ) ) {

[1992] Fix | Delete

$comment_author = $_COOKIE[ 'comment_author_' . COOKIEHASH ];

[1993] Fix | Delete

}

[1994] Fix | Delete

[1995] Fix | Delete

$comment_author_email = '';

[1996] Fix | Delete

if ( isset( $_COOKIE[ 'comment_author_email_' . COOKIEHASH ] ) ) {

[1997] Fix | Delete

$comment_author_email = $_COOKIE[ 'comment_author_email_' . COOKIEHASH ];

[1998] Fix | Delete

}

[1999] Fix | Delete