看板初始化提交

2026-06-01 21:23:12 -07:00
commit 54a842f4ab
2104 changed files with 241695 additions and 0 deletions
@@ -0,0 +1,121 @@
+<?php
+
+namespace Kanboard\Helper;
+
+use Kanboard\Core\Markdown;
+use Kanboard\Core\Base;
+
+/**
+ * Text Helpers
+ *
+ * @package helper
+ * @author  Frederic Guillot
+ */
+class TextHelper extends Base
+{
+    /**
+     * HTML escaping
+     *
+     * @param  string   $value    Value to escape
+     * @return string
+     */
+    public function e($value)
+    {
+        return htmlspecialchars((string) $value, ENT_QUOTES, 'UTF-8', false);
+    }
+
+    /**
+     * Join with HTML escaping
+     *
+     * @param  $glue
+     * @param  array $list
+     * @return string
+     */
+    public function implode($glue, array $list)
+    {
+        array_walk($list, function (&$value) {
+            $value = htmlspecialchars($value, ENT_QUOTES, 'UTF-8', false);
+        });
+        return implode($glue, $list);
+    }
+
+    /**
+     * Markdown transformation
+     *
+     * @param  string    $text
+     * @param  boolean   $isPublicLink
+     * @return string
+     */
+    public function markdown($text, $isPublicLink = false)
+    {
+        $parser = new Markdown($this->container, $isPublicLink);
+        $parser->setSafeMode(true);
+        $parser->setMarkupEscaped(MARKDOWN_ESCAPE_HTML);
+        $parser->setBreaksEnabled(true);
+        return $parser->text($text ?: '');
+    }
+
+    /**
+     * Reply transformation
+     *
+     * @param  string   $username
+     * @param  string   $text
+     * @return string
+     */
+    public function reply($username, $text)
+    {
+        $res = t('%s wrote: ', $username).PHP_EOL.'> ';
+
+        $lines = preg_split("/\r\n|\n|\r/", $text);
+
+        return $res.implode(PHP_EOL.'> ', $lines);
+    }
+
+    /**
+     * Format a file size
+     *
+     * @param  integer  $size        Size in bytes
+     * @param  integer  $precision   Precision
+     * @return string
+     */
+    public function bytes($size, $precision = 2)
+    {
+        if ($size == 0) {
+            return 0;
+        }
+
+        $base = log($size) / log(1024);
+        $suffixes = array('', 'k', 'M', 'G', 'T');
+
+        return round(pow(1024, $base - floor($base)), $precision).$suffixes[(int)floor($base)];
+    }
+
+    /**
+     * Return true if needle is contained in the haystack
+     *
+     * @param  string   $haystack   Haystack
+     * @param  string   $needle     Needle
+     * @return boolean
+     */
+    public function contains($haystack, $needle)
+    {
+        return strpos($haystack, $needle) !== false;
+    }
+
+    /**
+     * Return a value from a dictionary
+     *
+     * @param  mixed   $id              Key
+     * @param  array   $listing         Dictionary
+     * @param  string  $default_value   Value displayed when the key doesn't exists
+     * @return string
+     */
+    public function in($id, array $listing, $default_value = '?')
+    {
+        if (isset($listing[$id])) {
+            return $this->helper->text->e($listing[$id]);
+        }
+
+        return $default_value;
+    }
+}