Plugin serendipity_event_staticpage DEV

This is a developer repository to smartify the current S9y serendipity_event_staticpage plugin and make it available with upcoming Serendipity 2.0/2.1.

Please use with care and always keep a backup copy of your updated plugin.

---

ToDo: ⬇️

• deep check, if any change broke anything with some more enhanced staticpage options (all normal behaviour is checked working!)
• future Todo - check possibility for an automated integration to templates using $template_global_config = array('navigation' => true)
• future Todo - refactor related category associations
• check staticpage authorid vs $serendipity['authorid'] (0 != 1)!
• Keep new check_config() method check for dtree.css? Is it worth being expensive here?
• Check some last remaining questions pasted as '// RQ: ' notes (- - - -)

---

Already done: ⬆️

• Remove old TODO file
• Added undocumented feature since 3.50 to the Readme
• Consistent cleanups - stringify booleans in config options, set and fix fallbacks and review sidebar plugin
• Fix $nav array exception gathering values for an entry without any navigational options set
• Workaround SQLite install bug, while not being able to ALTER and fully support other table changes (#377)
• Changed SVG since SVG title attributes were not read - see https://gist.github.com/davidhund/564331193e1085208d7e
• Changed requirement to min PHP 5.3, which removes deprecated sortByOrder() method.
• Added a "default fallback" frontend "plugin_staticpage_includeentry.tpl file", for the case it was previously set in a template OR included by an entry, when switching to a new theme without having this file.
• Fix access permissions in backend
• Append all CSS to eventData (includes earlier fix for frontend CSS)
• Consistent use of serendipity_db_bool() config default values
• Now uses load_language API - extends sidebar plugin to v.1.27
• Added S9y 2.0.0 - 2.0.99 backend configgroup placeholder ability by script
• Minor markup space fixes, update simplepagination, include iconizr template, added title for parent staticpage in list
• Fixed POST preview check
• Minor improvements to CSS
• Fixed $eventData[0]['type'] 'dir' replacements
• Fixed $eventData being changed by backend_media_rename hook
• Update simplePagination Lib
• Fixed MediaLibrary item path replacements on MOVE with Serendipity 2.1 DEV
• Note to use a theme unique filename for the related article template by freetags
• Use the new simple fallback parameter in serendipity_getTemplateFile()
• Remove RQ for double entry staticpage var
• Move 2cd fetchPlugins() call to only apply if in need
• Make db queries consistent
• Added language field info
• Fixed password protected pages not showing up
• Fix sidebar plugin dependency config value check to append dtree.css into stream. Updated plugin_staticpage_sidebar.tpl.
• Removed wrong used smartify sidebar dependency check for a certain CSS case - rule output not by option than by version now
• Fix showlist db-boolean sets/gets
• Add db-build case 21 for certain silent db error in the past (ALTER permissions). Now an error is shown in the backend only without spoiling the serendipity_editor.js
• Fix two commits for database changes with v.3.98 commit 36fd48b Changed meta fields, no longer custom properties and v.3.97 commit 43e0f86 Breadcrumb navigation as an independent option, which could happen to not apply in every case.
• Fix missing trim($str) and an empty output of the JS Tree Smarty var via template, while the empty(array) was not true. Sets the sidebar plugin to v.1.26
• Fix icon-info image notifier not displayed embedded, when sidebar plugin is not installed
• Update jquery.simplePagination.js
• Removed icon font usage and added SVG sprites with 2.0 instead
• Fixed JS spconfig_listPerPage and JS pagination function to happen on listentries pages only
• Changed dtree usage page links world image to something more smart
• Fixed styles now added to the END of eventData stream, while checking for existing styles (dtree)
• Add configuration grouper
• Add new config option to list entries pagination by N entries
• Add separators to streamed CSS
• Removed $serendipity['staticpageplugin']['JS_init'] since this had no effect for the dtree.js call [Keep it. Though still being in question!]
• Fixed dtree.js being included more than once, by making the called script name unique
• Fixed missing dtree.css includement, in case of having selected this option
• Fixed cookie issue with backend form template. Set responsive_template.tpl as "default" fallback on S9y >= 2.0
• Removed an old and wrong used registration, since 'in_array' already is an allowed $php_function, since S9y-1.7
• Fixed default selected fallback backend form when unset or expired cookie
• Fixed 2.0 backend template form chaining (4.08) and merge array backend form names uniquely
• Fixed preview button for existing pages with 2.0
• New: iconized entrylist/entryform tabbar for 2.0
• Better use fixUTFEntity method only for frontend template vars (articleformatitle and headline)
• Set backends form textformat option automatically to NO, on WYSIWYG usage (?) Yes. Has dependency in 2.0 entryproperties!
• Added - automark an entry as written by Wysiwyg-Editor via custom fields, to disable nl2br markup formating
• Fixed (html)specialchars double_encode to false for native ISO-8859-1 charsets for certain form input/testarea fields in backend and some Smarty output variables in backend/frontend (which updates plugin_staticpage_***.tpl files again)
• Added check for new SQLite3 OO database layer with PHP 5.4+
• Rename directory backend_templates. There is a risk that existing user template dirs have other files in it (not excluded by backend_show) (?) No.
• Move new backend template files into own or current backend_template directory (?) No.
• Renamed style_sp_s9yold.css to staticpage_backend.old.css
• Renamed old_backend_staticpage.tpl to backend_staticpage.old.tpl
• Re-integrated previously outsourced backend_show.php
• Fixed htmlspecialchars() for PHP >=5.4 with native, non-utf-8 language installs, which changed with PHP 5.4 from ISO-8859-1 to UTF-8
• Added new README_FOR_CUSTOM_FIELDS.txt
• Added new custom template, which now holds existing examples for custom properties, based on responsive template. This removes the custom examples in the responsive template.
• Some small fixes https://github.com/ophian/serendipity_event_staticpage/compare/v4.27...46320d9
• Associated 1:1 relation for staticpage related categories. Touches staticpages and staticpage_categorypage tables to support the latter 1:1 relations only, as of now. Old entries don't get touched by this, until they will be updated.
• Solve some last remaining questions pasted as '// RQ: ' notes (+ + + + +)
• Removed commented $related_category_entries code, since being unneeded for the solution with serendipity_fetchPrintEntries and unworth to keep, since not really working.
• Removed old and unused getSistersID method
• Removed old and unused sequencer pageorder methods to use with javascript drag & drop only
• Fixed 2.0 Markup in category hook, the example markup in related category Readme, set some more form info and minor association with related category id and the corresonding table on delete
• Added more backend title attribute information for pageorder and entrylisting titles
• Touch frontend templates (in this plugin dir) for HTML5, inline styles, Navigations, etc
• Fix and correct entrypaging, breadcrumb and childpage navigations
• Changed for 2.0: added title attribute #ID to sequencer pagetitle, to know which id is meant by childpages
• Changed for 2.0: fixed save pageorder to work with current current 2.0 changes
• Changed for 2.0: default config value for show entrylist is now true
• Done for 2.0: since now using Smarty 3 only, some Smarty code will need a refresh (no need, but cleaner)
• Main backend CSS was renamed to staticpage_backend.css and now includes separately into backends page header
• Added for 2.0: include new staticpage_backend.js to templates page footer - no need to use 2.0 js hook
• Hide/Show the top tab bar menu per JS hideaway, since not used very often
• Add sorting filter function to entrylists - no need, since using simplePagination now (!)
• Navigate with larger amount of entrylist pages per newly added simplePagination.js, fits nice from 8 to some deci- pages
• Note, that some constants were added, removed or changed
• Added some missing and changed some method PHPDocs
• Added for 2.0: experimental entrylistings (entrylisting and pageorder sequencer) respect parent/child staticpages treeview listing in a simple way
• Added for 2.0: collapsible boxes icon change and use a universal setLocalStorage() and another for retrieve
• Added new simpler pageorder table fetcher
• Added for 2.0: form submit save-toolbar-button is now disabled when using the CKEDITOR full-package
• Added compat fallback to defaultform_template in case of cookie stored 'all fields/non-template' (old hardcoded) form
• Changed method name getSystersID() to getSisterID()
• Prepare everything to HTML5, which will be the default in future
• Prepare everything and purge plugins hardcoded non-smarty output
• Remove the 'no template' hardcoded stuff
• Plain Editor button changes for the 2.0 backend
• Extend required Serendipity version to 1.7 and Smarty 3.1, since the old_backend_staticpage.tpl would need too much old Smarty2 and CSS fixes
• Added confirmation dialog on select change page events, to avoid saving into wrong page accidently
• Moved listentries _new submit footer to also show up on empty list
• Added new config option to show last_modified or created_on date in plugin_staticpage.tpl (needs to change templates with already supplied files!)
• Applied some plain button changes for 2.0 previously bumped as 4.06
• Added a responsive custom (mobile) template, to replace the old 'no Template' (previously named 'All Fields' form)
• Finalize the version stylesheets for this
• Finalize 'backend_staticpage.tpl' for Serendipity 2.0 only usage
• Keep 'old_staticpage_backend.tpl' for previous S9y versions
• Reworked default form template by switching new_backend
• Added new 'pagetype' typeform template
• Set required S9y version to 1.6, due to smarty usage in sequencer 'pageorder' drag&drop
• Smartified the backend as much as possible
• Outsourced and changed some heavy markup functions, due to a better overview
• Changed form template names
• Added in 'pageorder' a new drag&drop sequencer, to automatically set the new list order on drop
• Added some CSS and include by version files
• Fixed tabs and 'pageadd' markup/css
• Fixed backend_templates/default_staticpage_backend.tpl smarty markup (escape and cke-wysiwyg)
• Fixed some plugin file code inconsistencies
• Fixed some minor markup errors
• New option: sets publishstatus (default draft) as default
• New option: sets listentries (selectbox default), due to errors in combination with selectlist
• Fixed (4.06) new entrylist markup

---

Undocumented Features

Postby garvinhicking » Wed Jun 13, 2007 12:36 pm in http://board.s9y.org/viewtopic.php?p=57362#57362

New staticpage feature: Show staticpages via Smarty

I just upgraded the staticpage plugin in CVS to version 3.50.

It now supports to use a custom smarty function to show static pages. This can be used in your custom template files (like the userprofile .tpls *) to emit specific staticpages depending on variables.

Go ahead and play with it. The API is quite basic and described in the new 'smarty.inc.php' file. It basically works like this:

(*) by the User-Profiles-Plugin

{staticpage_display template="$TEMPLATE" pagevar="$PAGEVAR" id="$ID" permalink="$PERMALINK" pagetitle="$PAGETITLE" authorid="$AUTHORID" query="$QUERY"}

Variable options:

• $TEMPLATE can be replaced with the name of the staticpage template to parse. It defaults to "plugin_staticpage.tpl".
• $PAGEVAR must match the variable prefix of the staticpage template. If you want to parse multiple staticpages, you might need to seperate those from each other. Always use the variable prefix that is also employed in the template file.

To retrieve a staticpage, you need to supply either one of those options:

• $ID can be replaced with the ID of the staticpage you want to fetch.
• $PERMALINK can be replaced with the fully configured permalink of a staticpage.
• $PAGETITLE can be replaced with the URL shorthand/backwards compatibility name of a staticpage
• $AUTHORID additionally can be combined with the variables above to restrict output to a specific author

If you need more customization, you can pass a SQL query directly using $QUERY.

EXAMPLE: To fetch a static page with the URL shorthand name 'static' you simply put this in your template file (index.tpl, a userprofile .tpl or whatever):

{staticpage_display pagetitle='static'}