Snowflakes Display Modification c/o Chen Zhen
Copyright 2014 - 2023, Chen Zhen @ web-develop.ca
Compatible with the SMF 2.0.X & SMF 2.1.X branches
Requirements: PHP 7.1 or better, modern mainstream browser


This installation process will add options to the mod settings template
which will allow an administrator to opt various types of snowflake and animated image scripts.
This will allow all your users to view these scripts on all of your website pages.

Distributed under the GNU Lesser General Public License version 3

---

Available effects:

• Four types of snowflakes: Snowflakes, Flurry, Diverse & Snowstorm
• Fireworks
• Flying Bats
• Xmas Lights
• Xmas Light Strands
• Xmas Wired Lights
• Random (some/all of the above)
• Many more available under the headings of "Diverse" & "Halloween" (ie. rain, leaves, bees, butterflies, doves, etc.)
• Your own images can be uploaded in the Halloween, Diverse or Xmas Wired Lights options

Available options:

• Various settings for all of the effects (available when each are selected in the admin)
• Enable/disable options for:  modification, members, specific actions/sub-actions, mobile or tablet detection
• Ability to enable/disable JQuery library for the SMF 2.0 branch (ie. disable when already available from another modification)
• Upload/change images for some of the effects

---

Version History
---------------
v1.83
+ added: option to disable light effects on vertical cursor range

v1.82
! fixed: save selected image in Snowflakes admin

v1.81
! fixed: abs() no longer supports numeric conversion in PHP 8.0.0+

v1.80
! fixed: check if array is set in HTTP mobile headers function

v1.79
+ added: default actions that render Snowflakes disabled
! removed: redundant/duplicate code from some files
! fixed: majority of the main scripts loaded after the DOM
! fixed: top_section/welcome container detection to hide lights during user interface

v1.78
! fixed: undefined variable concerning current action

v1.77
+ added: option to hide the Google Translate Toolbar
! fixed: all lights/snowflakes containers contain the notranslate class in case of Google Translate usage

v1.76
! fixed: check $_REQUEST where $context action|sub-action are not available

v1.75
+  added: additional native JavaScript files
!* fixed: check for JQuery prior to adding its library (SMF 2.0)
!* fixed: buffer amendments function reworked
!  fixed: uninstall process now removes all JavaScript files

v1.74
! fixed: no image directory check for empty path name

v1.73
! fixed: Xmas Wired Lights display none/flex for mouseover/mouseout
! fixed: Diverse & Fireworks use last child of body tag instead of #wrapper id
! fixed: missing concatenating assignment operator for $context['settings_insert_below']
! fixed: body overflowY & position properties for Fireworks
! fixed: Xmas Light Strands script for SMF 2.0

v1.72
! fixed: conflict with SMF 2.0.X branch post preview template

v1.71
! fixed: checking if constants are already defined

v1.7
+ added: new wired lights effect
! fixed: mobile/tablet detection
! fixed: snowstorm options for SMF 2.0 branch
! fixed: explosion animation for smash lights effect

v1.62
+ added: mouseenter/mouseover events for menus and search
+& added: admin options for mouseover/mouseenter events
! adjusted ion.sound to only use HTML5 audio
! fixed: onload event for various scripts that do not use JQuery (affects SMF 2.0)

v1.61
+ added: one additional light smash mp3 file
! fixed: smash lights script to only play one sound per bulb smash
! fixed: smash lights script to ensure it only loads one instance

v1.6
+& added: new light strands effect
+ any script requiring sound will now use the Ion.Sound 3.0.7 plug-in
+ all scripts are now compressed for stable versions
- SoundManager2 completely removed from smash lights script
! fixed: Javascript objects for snowstorm effect
! fixed: admin settings for snowstorm effect
! fixed: Javascript for smash lights effect
! fixed: Javascript node for smash lights effect now loaded using DOM
! fixed: css for exploding lights
! fixed: default offset height for smash lights effect on SMF 2.1 branch
! fixed: default settings for smash lights effect no longer sets or disables append & admin-view options

v1.5
+& added: mobile detection as another disable option
+& added: tablet detection as another disable option
+& license changed to: GNU Lesser General Public License version 3
! permission settings fixed: for both SMF branches
! profile menu icon fixed: for SMF 2.0 branch

v1.42
+& added: profile permissions to the Snowflakes admin template
+& disabling Snowflakes for actions/subactions behavior has changed (see help text in admin)
! fixed: misspelled help text
! fixed: member database function (missing key column for replace/insert)

v1.41
+& added: permission to allow membergroups profile option of enable/disable Snowflakes
! fixed: profile and permission functions
! fixed: SMF 2.1 profile area hook

v1.4
+& added: admin options to disable Snowflakes during specific SMF actions and/or subactions

v1.3
+ updated included JQuery library to v3.3.1
+ added: admin option to select Xmas lights container height
- removed utf-8 language files (existing language files are utf-8)
- eliminated redundant flash files
! fixed: deprecated msie detection
! fixed: css for lights
! fixed: instance of window.onload changed to eventListener
! fixed: instances of (window).load(function(){...}) changed to (window).on("load, function(){...})
! lights offset now "em" instead of "px" and floating value input allowing negative to positive range: -10.99 to 10.99

v1.2
+ added: random Snowflake script option
+ added: optional top px offset value for Xmas Lights script
! fixed: help text
! fixed: token validation for SMF 2.1.X
! fixed: image resizing for invalid or corrupt file types
! fixed: form multipart/form-data on Snowflakes admin template
! Snowflakes image folder no longer removed during the uninstall process

v1.1
+ Snowflakes now utilizes its own snowflakes_settings table
+ all settings are now mostly script/effect specific
+ added: lightbulbs script
+ installer now applies defaults where no settings exist for specific scripts
+ users have option to disable Snowflakes within their profile settings
+ membergroup permissions
+ file edit no longer necessary
! fixed: issue within snowflakesSMF.php file which affected some environments

v1.0
+ adds options for Snowflakes under the heading of Modification Settings
+ many options available for control ( more are pending )
+ 7 optional scripts available for varied effects

Disclaimer:

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

SMF_snowflakes-v1.83.zip 698.44 KB v1.83 2.0.19, 2.1.4

Manual installation info 2.0.18 2.0.19 2.1 RC4 2.1.1 2.1.2 2.1.4