Title: Hello Dolly For Your Song
Author: unmus
Published: <strong>2013年5月4日</strong>
Last modified: 2025年9月4日

---

プラグインを検索

![](https://ps.w.org/hello-dolly-for-your-song/assets/banner-772x250.png?rev=1628679)

このプラグインは **WordPress の最新3回のメジャーリリースに対してテストされていま
せん**。もうメンテナンスやサポートがされていないかもしれず、最新バージョンの WordPress
で使用した場合は互換性の問題が発生する可能性があります。

![](https://ps.w.org/hello-dolly-for-your-song/assets/icon-256x256.png?rev=1488377)

# Hello Dolly For Your Song

 作者: [unmus](https://profiles.wordpress.org/unmus/)

[ダウンロード](https://downloads.wordpress.org/plugin/hello-dolly-for-your-song.0.20.zip)

 * [詳細](https://ja.wordpress.org/plugins/hello-dolly-for-your-song/#description)
 * [レビュー](https://ja.wordpress.org/plugins/hello-dolly-for-your-song/#reviews)
 *  [インストール](https://ja.wordpress.org/plugins/hello-dolly-for-your-song/#installation)
 * [開発](https://ja.wordpress.org/plugins/hello-dolly-for-your-song/#developers)

 [サポート](https://wordpress.org/support/plugin/hello-dolly-for-your-song/)

## 説明

This simple plugin is an extended version of the famous hello dolly plugin by Matt
Mullenweg. Every human being has a special relationship to a particular song. And
because of that, Hello Dolly For Your Song brings the lyric of your favourite song
in the blog. But of course it can be used for any text. 😉

#### Features

 * Display a random line of a custom text in your blog as gutenberg block
 * Display a random line of a custom text in your blog as widget
 * Display a random line of a custom text in your blog as shortcode
 * Display a random line of a custom text in your theme as template tag
 * Display a random line of a custom text in the blog administration
 * Integration into WordPress REST API
 * Hooks for Developers
 * Options Page to define a custom song text
 * Site Health Integration
 * Hidden Options
 * Languages: English, German, Spanish, French, Indonesian, Russian

#### Related Links

 * [Official Plugin Page](https://www.unmus.de/hello-dolly-for-your-song/) (German)
 * [Why I have created this plugin?](https://www.unmus.de/hello-dolly/) (German)
 * [ScreenCast showing almost all features](https://www.unmus.de/hello-dolly-for-your-song/#screencast)(
   German)
 * [Source Code @ GitHub](https://github.com/circuscode/hello-dolly-for-your-song)

### Configuration

 1. Maintain the songtext you love in the Settings.
 2. That is all!

#### Gutenberg Block Category

Widgets

#### Shortcode

[hdfys]

#### Template Tag

hello_dolly_for_your_song()

#### Get Function

get_hello_dolly_for_your_song()

#### REST API Endpoint

http://yourblogdomain/wp-json/restful-hello-dolly-for-your-song/text

#### Actions

hdfys_new_song
 This Action wil be fired, if a new text was maintained in the settings.
You can use the following code.

    ```
    function hdfys_do_anything() {

        // Add your code to execute here

    }
    add_action( 'hdfys_new_song', 'hdfys_do_anything', 10, 3 );
    ```

#### Filter

hdfys_output_filter
 The filter will be applied before output of the gutenberg block,
template tag and shortcode. You can use the following code.

    ```
    function hdfys_output_manipulate( $output ) {

        // Add your filter code here
        // Example: $output=strtolower( $output );

        return $output;
    }
    add_filter( 'hdfys_output_filter', 'hdfys_output_manipulate', 10, 1 );
    ```

## スクリーンショット

[⌊Options Page⌉⌊Options Page⌉[

Options Page

## ブロック

このプラグインは1個のブロックを提供します。

 *   Hello Dolly Your Song

## インストール

 1. Download the plugin from the WordPress Plugin Repository
 2. Activate the plugin in WordPress
 3. Go to Settings > Hello Dolly Your Song to configure your songtext

## FAQ

### I have not maintained a songtext, nevertheless some lyrics is displayed in the admin head.

This is Hello Dolly by Louis Armstrong. If no text is maintained in the options,
the programm uses the songtext of Hello Dolly.

### Where do I find the gutenberg block?

You find the block in the category “widgets”.

### How can I use the shortcode?

Type [hdfys] in a blank line in the WordPress editor.

### How can I bring the widget in the blog with a custom widget title?

You can define the title in the settings of the widget.

### How can I integrate the random lyric in the theme?

Use the template tag hello_dolly_for_your_song() in your theme file. The random 
line will directly printed embedded within a container.

### I do only want to use the capabilities in the frontend and fade out the text in the admin panel. Is this possible?

You can use the hidden option for that! Please set the option “hdfys_admin_lyric”
to 0 in the table wp_options within your WordPress database. Because of that the
lyric in the admin panel will be faded out. Going back to standard settings, just
set the value to 1.

### Can I assign custom css?

Yes, you can. Each output of this plugin has individual css classes. Please use 
your debugging tools, to find the classes.

### How can I deinstall Hello Dolly For Your Song?

You can use the regular way on the plugin page. After deinstallation your wordpress
is really clean.

### I have maintained a continuous text and this breaks the admin layout partly?

Helly Dolly For Your Song works for texts in poem style. This means you need a text
with word wraps after each line or sentence. If you want to use a continuous text
in the plugin, you should add word wraps after each sentence.

### Does the plugin provide an API?

You can access the random line with the function get_hello_dolly_for_your_song()
in other plugin code or via functions.php. The function returns just one single 
random line without markup for further processing.

### Does the plugin supports the WordPress REST API?

Yes! 😀 You can access the endpoint with http://yourblogdomain/wp-json/restful-hello-
dolly-for-your-song/text. The endpoint delivers one random line back. So it’s not
really REST, it’s only “READ”.

### Is is possible to manipulate the HTML-output before rendering?

The HTML-oupt of the gutenberg block, template tag or shortcode can be manipulated.
This will be made with the Filter hdfys_output_filter. Below you find a code example.

### Why is the random line not shown on all admin pages?

Several admin pages like settings are excluded, because some plugins do not use 
the wordpress standard layout. To avoid breaks in the user design, these pages are
excluded.

## 評価

このプラグインにはレビューがありません。

## 貢献者と開発者

Hello Dolly For Your Song はオープンソースソフトウェアです。以下の人々がこのプラグ
インに貢献しています。

貢献者

 *   [ unmus ](https://profiles.wordpress.org/unmus/)
 *   [ jordansilaen ](https://profiles.wordpress.org/jordansilaen/)

“Hello Dolly For Your Song” は1ロケールに翻訳されています。 [翻訳者](https://translate.wordpress.org/projects/wp-plugins/hello-dolly-for-your-song/contributors)
のみなさん、翻訳へのご協力ありがとうございます。

[“Hello Dolly For Your Song” をあなたの言語に翻訳しましょう。](https://translate.wordpress.org/projects/wp-plugins/hello-dolly-for-your-song)

### 開発に興味がありますか ?

[コードを閲覧](https://plugins.trac.wordpress.org/browser/hello-dolly-for-your-song/)
するか、[SVN リポジトリ](https://plugins.svn.wordpress.org/hello-dolly-for-your-song/)
をチェックするか、[開発ログ](https://plugins.trac.wordpress.org/log/hello-dolly-for-your-song/)
を [RSS](https://plugins.trac.wordpress.org/log/hello-dolly-for-your-song/?limit=100&mode=stop_on_copy&format=rss)
で購読してみてください。

## 変更履歴

#### 0.20

 * september 2025
 * Security: REST API Permission Callback added

#### 0.19

 * april 2024
 * Security: Echo Escaping added

#### 0.18

 * april 2023
 * Bugfix: LastChar is blank
 * Bugfix: Installation Process
 * Changed: Page Uploads excluded
 * Others: Depreciated Authorization replaced

#### 0.17

 * may 2020
 * Russian Translation
 * Better Code Documentation
 * Bugfix: Broken Plugin Administration Link
 * Many internal improvements

#### 0.16

 * march 2020
 * Site Health Integration
 * Code Improvement

#### 0.15

 * january 2019
 * Gutenberg Support
 * Update Process Bugfix
 * New Activation Criteria

#### 0.14

 * april 2018
 * Random Line will printed on “classic” admin pages only

#### 0.13

 * 13 january 2018
 * Gutenberg Plugin Support
 * Automatic Removal of Empty Lines
 * Plugin Actions
 * Plugin Filters
 * Code Improvement

#### 0.12

 * 16 july 2017
 * Integration into WordPress REST API
 * Source Code Comments to make wordpress plugin development concepts more transparent

#### 0.11

 * 04 april 2017
 * Template Tag does not require Echo command anymore
 * New Function available to get the raw random line for processing
 * New Language: Indonesian

#### 0.10

 * 18 march 2017
 * Options Link @ Plugin Page

#### 0.9

 * 26 december 2016
 * French Language
 * Hidden Options
 * Security Improvements
 * Internal Optimization

#### 0.8

 * 1 september 2016
 * Template Tag
 * New Labels
 * Code Improvement

#### 0.7

 * 27 august 2016
 * Settings API
 * Update Process

#### 0.6

 * 09 august 2014
 * Spanish Language

#### 0.5

 * 06 september 2013
 * Shortcode
 * Custom Widget Title

#### 0.4

 * 26 june 2013
 * Widget
 * Localization
 * German language
 * Clean deinstallation
 * Bugfix: Processing of apostrophes

#### 0.3

 * 5 may 2013
 * Structured and readable code
 * First published version

#### 0.2

 * 4 may 2013
 * Running version without errors

#### 0.1

 * 3 may 2013
 * Running version

## メタ

 *  バージョン **0.20**
 *  最終更新日 **1年前**
 *  有効インストール数 **40+**
 *  WordPress バージョン ** 5.2またはそれ以降 **
 *  検証済み最新バージョン: **6.8.11**
 *  PHP バージョン ** 7.0またはそれ以降 **
 *  言語
 * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/hello-dolly-for-your-song/)、
   [English (US)](https://wordpress.org/plugins/hello-dolly-for-your-song/).
 *  [プラグインを翻訳](https://translate.wordpress.org/projects/wp-plugins/hello-dolly-for-your-song)
 * タグ
 * [admin](https://ja.wordpress.org/plugins/tags/admin/)[hello world](https://ja.wordpress.org/plugins/tags/hello-world/)
   [love](https://ja.wordpress.org/plugins/tags/love/)[random](https://ja.wordpress.org/plugins/tags/random/)
 *  [詳細を表示](https://ja.wordpress.org/plugins/hello-dolly-for-your-song/advanced/)

## 評価

レビューはまだ送信されていません。

[Your review](https://wordpress.org/support/plugin/hello-dolly-for-your-song/reviews/#new-post)

[すべてのレビューを見る](https://wordpress.org/support/plugin/hello-dolly-for-your-song/reviews/)

## 貢献者

 *   [ unmus ](https://profiles.wordpress.org/unmus/)
 *   [ jordansilaen ](https://profiles.wordpress.org/jordansilaen/)

## サポート

意見や質問がありますか ?

 [サポートフォーラムを表示](https://wordpress.org/support/plugin/hello-dolly-for-your-song/)