Changeset 12787

Timestamp:

08/01/2023 10:45:26 PM (3 years ago)

Author:

coffee2code

Message:

Photo Directory, Photo: Improve some inline docs.

File:

• sites/trunk/wordpress.org/public_html/wp-content/plugins/photo-directory/inc/photo.php (modified) (7 diffs)

sites/trunk/wordpress.org/public_html/wp-content/plugins/photo-directory/inc/photo.php

@@ -172 +172 @@
      * though it appears to be related to the image files themselves and doesn't
      * affect all files. Perhaps the stream is not a seekable as the
-     * `exif_read_data()`docs suggest it needs to be.
+     * `exif_read_data()` docs suggest it needs to be.
      *
      * This function essentially copies `wp_read_image_metadata()`. If that
@@ -179 +179 @@
      * - A check was added to the very beginning to bail early if EXIF had been extracted.
      * - The calls to `exif_read_data()` have been commented out and a call to
-     *   `self::exif_read_data_as_data_stream()` as been added instead.
+     *   `self::exif_read_data_as_data_stream()` has been added instead.
      *
      * Look for 'Start of retry_exif_read() specific changes here. ' to denote the
@@ -453 +453 @@
      *                     of a known photo as obviously the provided hash
      *                     would match itself.
-     * @return bool True is the MD5 hash matches one for an existing photo.
+     * @return bool True if the MD5 hash matches one for an existing photo.
      */
     public static function hash_exists( $hash ) {
@@ -478 +478 @@
      *                       false.
      * @return array|false   Associative array of analysis info or false if the
-     *                       image was invalid or not data was retrieved.
+     *                       image was invalid or no data was retrieved.
      */
     public static function fetch_analysis_from_api( $image_id, $force = false ) {
@@ -514 +514 @@
      *                       false.
      * @return array|false   Associative array of analysis info or false if the
-     *                       image was invalid or not data was retrieved.
+     *                       image was invalid or no data was retrieved.
      */
     public static function get_analysis( $image_id, $force = false ) {
@@ -818 +818 @@
      * @param int   $post_id          The ID of the photo post type post.
      * @param array $skip_likelihoods Likelihoods to skip due to not being of concern.
+     *                                Default ['very_unlikely', 'unlikely'].
      * @return array
      */
@@ -1001 +1002 @@
 
         if ( get_current_user_id() === $moderator_id ) {
-            $link = '<b>you</b>';
+            $link = '<b>' . __( 'you', 'wporg-photos' ) . '</b>';
         } else {
             $link = sprintf(