From 66dc228be81d0ca78e1689f675a8040ee92f0016 Mon Sep 17 00:00:00 2001 From: friendica Date: Sat, 8 Mar 2014 21:13:42 -0800 Subject: HOWTO create a derived theme lesson 1. Do not attempt to do anything more complicated until you have successfully completed this exercise. --- doc/DerivedTheme1.md | 78 ++++++++++++++++++++++++++++++++++++++++++++++++++++ doc/main.bb | 1 + 2 files changed, 79 insertions(+) create mode 100644 doc/DerivedTheme1.md (limited to 'doc') diff --git a/doc/DerivedTheme1.md b/doc/DerivedTheme1.md new file mode 100644 index 000000000..d20a958f2 --- /dev/null +++ b/doc/DerivedTheme1.md @@ -0,0 +1,78 @@ +Creating a Derived Theme +======================== + +**Lesson 1** + +A derived theme takes most of the settings from its "parent" theme and lets you change a few things to your liking without creating an entire theme package. + + +To create a derived theme, first choose a name. For our example we'll call our theme 'mytheme'. Hopefully you'll be a bit more creative. But throughout this document, wherever you see 'mytheme', replace that with the name you chose. + +**Directory Structure** + +First you need to create a theme directory structure. We'll keep it simple. We need a php directory and a css directory. Here are the Unix/Linux commands to do this. Assume that 'mywebsite' is your top level Red Matrix folder. + + + cd mywebsite + mkdir view/theme/mytheme + mkdir view/theme/mytheme/css + mkdir view/theme/mytheme/php + + +Great. Now we need a couple of files. The first one is your theme info file, which describes the theme. + +It will be called view/theme/mytheme/php/theme.php (clever name huh?) + +Inside it, put the following information - edit as needed + + theme_info['extends'] = 'redbasic'; + + + } + + +Remember to rename the mytheme_init function with your theme name. In this case we will be extending the theme 'redbasic'. + + +Now create another file. We call this a PCSS file, but it's really a PHP file. + +The file is called view/theme/mytheme/php/style.php + +In it, put the following: + + Display Settings as their default theme. + + + \ No newline at end of file diff --git a/doc/main.bb b/doc/main.bb index a9ee3c5d8..7895931a9 100644 --- a/doc/main.bb +++ b/doc/main.bb @@ -39,6 +39,7 @@ [zrl=[baseurl]/help/Creating-Templates]Creating Comanche Templates[/zrl] [zrl=[baseurl]/help/Widgets]Core Widgets[/zrl] [zrl=[baseurl]/help/plugins]Plugins[/zrl] +[zrl=[baseurl]/help/DerivedTheme1]Creating Derivative Themes[/zrl] [zrl=[baseurl]/help/schema_development]Schemas[/zrl] [zrl=[baseurl]/help/developers]Developers[/zrl] [zrl=[baseurl]/help/intro_for_developers]Intro for Developers[/zrl] -- cgit v1.2.3 From e1e107e4241bb0dfd5c8af7d7c4b9db8c5d0ce5d Mon Sep 17 00:00:00 2001 From: friendica Date: Sat, 8 Mar 2014 23:18:34 -0800 Subject: advanced directory search help file --- doc/AdvancedSearch.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/main.bb | 1 + 2 files changed, 56 insertions(+) create mode 100644 doc/AdvancedSearch.md (limited to 'doc') diff --git a/doc/AdvancedSearch.md b/doc/AdvancedSearch.md new file mode 100644 index 000000000..8bcd5de69 --- /dev/null +++ b/doc/AdvancedSearch.md @@ -0,0 +1,55 @@ +Advanced Directory Search +========================= + + +Advanced Directory Search is enabled in "Expert Mode" from your Settings => Additional features page. + +On the Directory page an option named "Advanced" will apear in the "Find Channels" widget (typically in the sidebar). Clicking "Advanced" will open another search box for entering advanced search requests. + +Advanced requests include + +* name=xxx +[Channel name contains xxx] + +* address=xxx +[Channel address (webbie) contains xxx] + +* locale=xxx +[Locale (typically 'city') contains xxx] + +* region=xxx +[Region (state/territory) contains xxx] + +* postcode=xxx +[Postcode or zip code contains xxx] + +* country=xxx +[Country name contains xxx] + +* gender=xxx +[Gender contains xxx] + +* marital=xxx +[Marital status contains xxx] + +* sexual=xxx +[Sexual preference contains xxx] + +* keywords=xxx +[Keywords contain xxx] + +There are many reasons why a match may not return what you're looking for, as many channels do not provide detailed information in their default (public) profile, and many of these fields allow free-text input in any language which is difficult to match precisely. + +Requests may be joined together with 'and', 'or', and 'and not'. + +Terms containing spaces must be quoted. + +Example: + + name="charlie brown" and country=canada and not gender=female + + + + + + diff --git a/doc/main.bb b/doc/main.bb index 7895931a9..634bb524c 100644 --- a/doc/main.bb +++ b/doc/main.bb @@ -23,6 +23,7 @@ [zrl=[baseurl]/help/bbcode]BBcode reference for posts and comments[/zrl] [zrl=[baseurl]/help/checking_account_quota_usage]Checking Account Quota Usage[/zrl] [zrl=[baseurl]/help/cloud_desktop_clients]Cloud Desktop Clients[/zrl] +[zrl=[baseurl]/help/AdvancedSearch]Advanced Directory Search[/zrl] [b]For Hub Administrators[/b] -- cgit v1.2.3 From 8b04db794f72d620aff1f10a7e580ad6b09681a4 Mon Sep 17 00:00:00 2001 From: friendica Date: Sat, 8 Mar 2014 23:45:26 -0800 Subject: describe the known flaws --- doc/AdvancedSearch.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/AdvancedSearch.md b/doc/AdvancedSearch.md index 8bcd5de69..5a9a5a3bc 100644 --- a/doc/AdvancedSearch.md +++ b/doc/AdvancedSearch.md @@ -38,7 +38,9 @@ Advanced requests include * keywords=xxx [Keywords contain xxx] -There are many reasons why a match may not return what you're looking for, as many channels do not provide detailed information in their default (public) profile, and many of these fields allow free-text input in any language which is difficult to match precisely. +There are many reasons why a match may not return what you're looking for, as many channels do not provide detailed information in their default (public) profile, and many of these fields allow free-text input in several languages - and this may be difficult to match precisely. For instance you may have better results finding somebody in the USA with 'country=u' (along with some odd channels from Deutschland and Bulgaria and Australia) because this could be represented in a profile as US, U.S.A, USA, United States, etc... + +Future revisions of this tool may try to smooth over some of these difficulties. Requests may be joined together with 'and', 'or', and 'and not'. -- cgit v1.2.3