README

为iOS提供的Yii2 PWA '添加应用到屏幕'消息小部件

Progressive Web Apps '添加应用到屏幕'消息小部件。

正如您所知，如果您有兼容PWA的网站，Android会默认提示将其图标添加到桌面，但iOS没有这个功能，所以我们必须手动添加这样的消息。

此小部件仅在用户代理为iOS且我们不处于“独立”模式（应用已添加到屏幕）时，在页面底部添加消息。

关闭此消息框后，小部件会设置有限时间的cookie，当此cookie有效时，消息将不会显示（详细信息请参阅小部件配置）。

安装

安装此扩展的首选方式是通过composer。

运行以下命令：

$ php composer.phar require wiperawa/pwa-ios-add-to-screen-yii-widget "dev-master"

或者将以下内容添加到您的composer.json文件的require部分：

"wiperawa/pwa-ios-add-to-screen-yii-widget": "dev-master"

使用

以下是一个小部件使用示例，使用默认参数，如果您不想更改它，可以省略它们。

use wiperawa\pwa\IosAddToScreen\AddToScreenWidget;

//...

AddToScreenWidget::widget([
    'containerOptions' => [], 

    //Brand img url, should not be bigger than 48x48 px.
    'brandImg' => "@iosWidgetAssetUrl/img/brand-yii.png",

    // welcome text
    'welcomeText' => 'Install @appName on your IPhone: ',

    //instruction text
    'instructionText' => "push @iosShareImg and then @iosAddImg to screen 'Home'",

    //seconds, hide cookie lifetime, defaults to 1 year
    'cookieLifeTime' => 31536000,
    
    //iOS 'share' button img.
    'iosShareImg' => "@iosWidgetAssetUrl/img/ios-share.svg",

    //iOS 'add' button img
    'iosAddImg' => "@iosWidgetAssetUrl/img/ios-add.svg"
]);

如果您想使用翻译后的消息，请将@appName、@iosShareImg和@iosAddImg留在原处，小部件会自动替换它们。

汽车雨刷器 / pwa-ios-add-to-screen-yii-widget

维护者

详细信息

README

为iOS提供的Yii2 PWA '添加应用到屏幕'消息小部件

安装

使用