add getName method to element types

docs/extend/element-types.md

@@ -493,7 +493,7 @@ protected static function defineTableAttributes(): array
 ```
 
 ::: tip
-The first attribute you list here is a special case. It defines the header for the first column in the table view, which is the only one admins can’t remove. Its values will be the element string representations (whatever their `__toString()` methods return).
+The first attribute you list here is a special case. It defines the header for the first column in the table view, which is the only one admins can’t remove. Its values will come from your elements’ <api:craft\base\ElementInterface::getName()> method.
 :::
 
 If it’s a big list, you can also limit which columns should be visible by default for new [sources](#sources) by adding a protected `defineDefaultTableAttributes()` method to your element class:

src/base/Element.php

@@ -1263,14 +1263,22 @@ public function getLink()
         $url = $this->getUrl();
 
         if ($url !== null) {
-            $link = '<a href="' . $url . '">' . Html::encode($this->__toString()) . '</a>';
+            $link = '<a href="' . $url . '">' . Html::encode($this->getName()) . '</a>';
 
             return Template::raw($link);
         }
 
         return null;
     }
 
+    /**
+     * @inheritdoc
+     */
+    public function getName(): string
+    {
+        return (string)$this;
+    }
+
     /**
      * @inheritdoc
      */

src/base/ElementInterface.php

@@ -433,6 +433,13 @@ public function getUrl();
      */
     public function getLink();
 
+    /**
+     * Returns a string to be used in for links to edit this element.
+     *
+     * @return string
+     */
+    public function getName(): string;
+
     /**
      * Returns the reference string to this element.
      *

src/elements/User.php

@@ -913,9 +913,7 @@ public function getFullName()
     }
 
     /**
-     * Returns the user's full name or username.
-     *
-     * @return string
+     * @inheritdoc
      */
     public function getName(): string
     {

src/web/View.php

@@ -1761,7 +1761,7 @@ private function _getCpElementHtml(array &$context)
 
         $html .= '<span class="title">';
 
-        $label = HtmlHelper::encode($element);
+        $label = HtmlHelper::encode($element->getName());
 
         if ($context['context'] === 'index' && !$element->trashed && ($cpEditUrl = $element->getCpEditUrl())) {
             $cpEditUrl = HtmlHelper::encode($cpEditUrl);