+ *
+ */
+
+
+
+ function randplace_settings(&$a,&$s) {
+
+ if(! local_channel())
+ return;
+
+ /* Add our stylesheet to the page so we can make our settings look nice */
+
+ head_add_css('/addon/randplace/randplace.css');
+
+ /* Get the current state of our config variable */
+
+ $enabled = get_pconfig(local_channel(),'randplace','enable');
+
+ $checked = (($enabled) ? ' checked="checked" ' : '');
+
+ /* Add some HTML to the existing form */
+
+ $s .= 'title
+ * .... settings html - many elements will be floated... + * + * + *';
+ $s .= '
';
+
+ }
+
+
+
+
+
+***Advanced Plugins***
+
+Sometimes your plugins want to provide a range of new functionality which isn't provided at all or is clumsy to provide using hooks. In this case your plugin can also act as a 'module'. A module in our case refers to a structured webpage handler which responds to a given URL. Then anything which accesses that URL will be handled completely by your plugin.
+
+The key to this is to create a simple function named pluginname_module() which does nothing.
+
+ function randplace_module() { return; }
+
+Once this function exists, the URL https://yoursite/randplace will access your plugin as a module. Then you can define functions which are called at various points to build a webpage just like the modules in the mod/ directory. The typical functions and the order which they are called is
+
+ modulename_init($a) // (e.g. randplace_init($a);) called first - if you wish to emit json or xml,
+ // you should do it here, followed by killme() which will avoid the default action of building a webpage
+ modulename_aside($a) // Often used to create sidebar content
+ modulename_post($a) // Called whenever the page is accessed via the "post" method
+ modulename_content($a) // called to generate the central page content. This function should return a string
+ // consisting of the central page content.
+
+Your module functions have access to the URL path as if they were standalone programs in the Unix operating system. For instance if you visit the page
+
+ https://yoursite/randplace/something/somewhere/whatever
+
+we will create an argc/argv list for use by your module functions
+
+ $x = argc(); $x will be 4, the number of path arguments after the sitename
+
+ for($x = 0; $x < argc(); $x ++)
+ echo $x . ' ' . argv($x);
+
+
+ 0 randplace
+ 1 something
+ 2 somewhere
+ 3 whatever
+
+
+***Porting Friendica Plugins***
+
+The $Projectname uses a similar plugin architecture to the Friendica project. The authentication, identity, and permissions systems are completely different. Many Friendica can be ported reasonably easily by renaming a few functions - and then ensuring that the permissions model is adhered to. The functions which need to be renamed are:
+
+* Friendica's pluginname_install() is pluginname_load()
+
+* Friendica's pluginname_uninstall() is pluginname_unload()
+
+The $Projectname has _install and _uninstall functions but these are used differently.
+
+* Friendica's "plugin_settings" hook is called "feature_settings"
+
+* Friendica's "plugin_settings_post" hook is called "feature_settings_post"
+
+Changing these will often allow your plugin to function, but please double check all your permission and identity code because the concepts behind it are completely different in the $Projectname. Many structured data names (especially DB schema columns) are also quite different.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/Primary-Directory.md b/sources/doc/Primary-Directory.md
new file mode 100644
index 00000000..37b0c043
--- /dev/null
+++ b/sources/doc/Primary-Directory.md
@@ -0,0 +1,47 @@
+#Primary Directory#
+
+By default, $Projectname will use available Directories on the web, which show you channels available around the world.
+
+There are certain scenarios where you might want your own directory-server that you can connect multiple hubs to. This will limit the channels that appear in all of your hubs to only channels on hubs connected to your directory-server.
+
+
+
+##Instuctions on how to set up one hub as the Primary Directory for a series of private hubs.##
+***
+
+
+* On the hub that will be the Directory Server, open the .htconfig.php file and set:
+
+ `$a->config['system']['directory_mode'] = DIRECTORY_MODE_PRIMARY;`
+
+
+ By default it should already be set as **DIRECTORY_MODE_NORMAL**, so just edit that line to say **DIRECTORY_MODE_PRIMARY**
+
+* Next, for each hub (including the Directory Server), from a terminal, cd into the folder where it is installed and run this :
+
+ `util/config system directory_realm YOURREALMNAME`
+
+ (**YOURREALMNAME** can be whatever you want your realm-name to be)
+
+ then:
+
+ `util/config system realm_token THEPASSWORD`
+
+ (**THEPASSWORD** is whatever password you want for your realm)
+
+ **NOTE:** Use the same realm-name and password for each hub
+
+* Lastly, for each "client" hub, (from a terminal) run:
+
+ `util/config system directory_server https://theaddressofyourdirectoryserver.com`
+
+***
+Now when you view the directory of each hub, it should only show the channels that exist on the hubs in your realm. I have tested with two hubs so far, and it seems to be working fine.
+Channels created in each hub are reflected in the Primary Directory, and subsequently in the directory of all client hubs
+
+##Issues##
+***
+
+When I created the first hub,it was up and running for an hour or so before I changed it to PRIMARY_MODE, and after changing it, there were a few channels from across the matrix still present in the directory. I deleted them from the xchan table and that seems to have fixed the issue.
+
+
diff --git a/sources/doc/Privacy.md b/sources/doc/Privacy.md
new file mode 100644
index 00000000..fd6df631
--- /dev/null
+++ b/sources/doc/Privacy.md
@@ -0,0 +1,73 @@
+#Privacy Policy
+
+##Summary
+
+Q: Who can see my content?
+
+A: By default ANYBODY on the internet, UNLESS you restrict it. The $Projectname allows you to choose the privacy level you desire. Restricted content will NOT be visible to spy networks and their advertisers. It will be protected against eavesdropping by outsiders - to the best of our ability. Hub administrators with sufficient skills and patience MAY be able to eavesdrop on some private communications but they must expend effort to do so. Privacy modes exist within the $Projectname which are even resistant to eavesdropping by skilled and determined hub administrators.
+
+Q: Can my content be censored?
+
+A: The $Projectname (the network) CANNOT censor your content. Server and hub administrators are subject to local laws and MAY remove objectionable content from their site/hub. Anybody MAY become a hub administrator, including you; and therefore publish content which might otherwise be censored. You still MAY be subject to local laws.
+
+
+##Definitions
+
+**$Projectname**
+
+Otherwise referred to as "the network", the $Projectname is a collection of individual computers/servers (aka **hubs**) which connect together to form a larger cooperative network.
+
+**hub**
+
+An individual computer or server connected to the $Projectname. These are provided by a **hub administrator** and may be public or private, paid or free.
+
+**hub administrator**
+
+The system operator of an individual hub.
+
+##Policies
+
+**Public Information**
+
+Any information or anything posted by you within the $Projectname MAY be public or visible to anybody on the internet. To the extent possible, the $Projectname allows you to protect content and restrict who can view it.
+
+Your profile photo, your channel name, and the location (URL or network address) of your channel are visible to anybody on the internet and privacy controls will not affect the display of these items.
+
+You MAY additionally provide other profile information. Any information which you provide in your "default" or **public profile** MAY be transmitted to other hubs in the $Projectname and additionally MAY be displayed in the channel directory. You can restrict the viewing of this profile information. It may be restricted only to members of your hub, or only connections (friends), or other limited sets of viewers as you desire. If you wish for your profile to be restricted, you must set the appropriate privacy setting, or simply DO NOT provide additional information.
+
+**Content**
+
+Content you provide (status posts, photos, files, etc.) belongs to you. The $Projectname default is to publish content openly and visible to anybody on the internet (PUBLIC). You MAY control this in your channel settings and restrict the default permissions or you MAY restrict the visibility of any single published item separately (PRIVATE). The $Projectname developers will ensure that restricted content is ONLY visible to those in the restriction list - to the best of their ability.
+
+Content (especially status posts) that you share with other networks or that you have made visible to anybody on the internet (PUBLIC) cannot easily be taken back once it has been published. It MAY be shared with other networks and made available through RSS/Atom feeds. It may also be syndicated on other $Projectname sites. It MAY appear on spy networks and internet searches. If you do not wish this default behaviour please adjust your channel settings and restrict who can see your content.
+
+**Comments and Forum posts**
+
+Comments to posts that were created by others and posts which are designated as forum posts belong to you as the creator/author, but the distribution of these posts is not under your direct control. These posts/comments MAY be re-distributed to others, and MAY be visible to anybody on the internet. In the case of comments, the creator of the "first message" in the thread to which you are replying controls the distribution of all comments and replies to that message.
+
+
+**Private Information**
+
+$Projectname developers will ensure that any content you provide which is designated as PRIVATE will be protected against eavesdropping - to the best of their ability. Private content is generally hidden or obscured even from hub administrators. It is also stripped from email notifications. It is difficult but NOT impossible for this content to be seen by a hub administrator. This is a side effect of the physical laws of the universe. Unfortunately, if a database needs to decrypt a post at display time, it must have the means to decrypt the post! End to end encryption is also provided and this CANNOT be seen, even by a determined administrator.
+
+##Identity Privacy
+
+Privacy for your identity is another aspect. Because you have a decentralized identity in the $Projectname, your privacy extends beyond your home hub. If you want to have complete control of your privacy and security you should run your own hub on a dedicated server. For many people, this is complicated and may stretch their technical abilities. So let's list a few precautions you can make to assure your privacy as much as possible.
+
+A decentralized identity has a lot of advantages and gives you al lot of interesting features, but you should be aware of the fact that your identity is known by other hubs in the $Projectname network. One of those advantages is that other channels can serve you customized content and allow you to see private things (such as private photos which others wish to share with you). Because of this those channels need to know who you are. But we understand that sometimes those other channels know more from you than you might desire. For instance the plug-in Visage that can tell a channel owner the last time you visit their profile. You can easily OPT-OUT of this low level and we think, harmless tracking.
+
+* You can enable [Do Not Track (DNT)](http://donottrack.us/) in your web browser. We respect this new privacy policy proposal. All modern browsers support DNT. You will find it in the privacy settings of your browsers or else you can consult the web browser's manual. This will not affect the functionality of the $Projectname. This setting is probably enough for most people.
+*You can [disable publication](settings) of your channel in our channel directory. If you want people to find your channel, you should give your channel address directly to them. We think this is a good indication that you prefer extra privacy and automatically enable "Do Not Track" if this is the case.
+* You can have a blocked hub. That means that all channels and content on that hub is not public, and not visible to the outside world. This is something only your hub administrator can do. We also respect this and automatically enable "Do Not Track" if it is set.
+
+###Censorship
+
+The $Projectname is a global network which is inclusive of all religions and cultures. This does not imply that every member of the network feels the same way you do on contentious issues, and some people may be STRONGLY opposed to the content you post. In general, if you wish to post something that you know may nor be universally acceptable, the best approach is to restrict the audience using privacy controls to a small circle of friends.
+
+The $Projectname as a network provider is unable to censor content. However, hub administrators MAY censor any content which appears on their hub to comply with local laws or even personal judgement. Their decision is final. If you have issues with any hub administrator, you may move your account and postings to another site which is more in line with your expectations. Please check (periodically) the [Terms of Service](help/TermsOfService) of your hub to learn about any rules or guidelines. If your content consists of material which is illegal or may cause issues, you are STRONGLY encouraged to host your own (become a hub administrator). You may still find that your content is blocked on some hubs, but the $Projectname as a network cannot block it from being posted.
+
+The $Projectname RECOMMENDS that hub administrators provide a grace period of 1-2 days between warning an account holder of content that needs to be removed and physically removing or disabling the account. This will give the content owner an opportunity to export their channel meta-data and import it to another site. In rare cases the content may be of such a nature to justify the immediate termination of the account. This is a hub decision, not a $Projectname decision.
+
+If you typically and regularly post content of an adult or offensive nature, you are STRONGLY encouraged to mark your account "NSFW" (Not Safe For Work). This will prevent the display of your profile photo in the directory except to viewers that have chosen to disable "safe mode". If your profile photo is found by directory administrators to be adult or offensive, the directory administrator MAY flag your profile photo as NSFW. There is currently no official mechanism to contest or reverse this decision, which is why you SHOULD mark your own account NSFW if it is likely to be inappropriate for general audiences.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/README.md b/sources/doc/README.md
new file mode 100644
index 00000000..90585a90
--- /dev/null
+++ b/sources/doc/README.md
@@ -0,0 +1,42 @@
+
+Hubzilla
+========
+
+###Websites. Redefined.
+
+
+
+
+**What are Hubs?**
+
+Hubs are independent general-purpose websites that not only connect with their associated members and viewers, but also connect together to exchange personal communications and other information with each other.
+This allows hub members on any hub to securely and privately share anything; with anybody, on any hub - anywhere; or share stuff publicly with anybody on the internet if desired.
+
+**Hubzilla** is the server software which makes this possible. It is a sophisticated and unique combination of an open source content management system and a decentralised identity, communications, and permissions framework and protocol suite, built using common webserver technology (PHP/MySQL/Apache, although Mariadb or Postgres and Nginx could also be used - we're pretty easy). The end result is a level of systems integration, privacy control, and communications features that you wouldn't think are possible in either a content management system or a decentralised communications network. It also brings a new level of cooperation and privacy to the web and introduces the concept of personally owned "single sign-on" to web services across the entire internet.
+
+Hubzilla hubs are
+
+* decentralised
+* inherently social
+* optionally inter-networked with other hubs
+* privacy-enabled (privacy exclusions work across the entire internet to any registered identity on any compatible hubs)
+
+Possible website applications include
+
+* decentralised social networking nodes
+* personal cloud storage
+* file dropboxes
+* managing organisational communications and activities
+* collaboration and community decision-making
+* small business websites
+* public and private media/file libraries
+* blogs
+* event promotion
+* feed aggregation and republishing
+* forums
+* dating websites
+* pretty much anything you can do on a traditional blog or community website, but that you could do better if you could easily connect it with other websites or privately share things across website boundaries.
+
+
+
+This project is under development and is not yet available for general use.
\ No newline at end of file
diff --git a/sources/doc/Remove-Account.md b/sources/doc/Remove-Account.md
new file mode 100644
index 00000000..a8ef733a
--- /dev/null
+++ b/sources/doc/Remove-Account.md
@@ -0,0 +1,26 @@
+// this page is out of date...
+Remove Account
+==============
+
+It is presently not possible to remove an account without asking your site administrator for assistance.
+We'll have better doco when somebody finishes that bit.
+
+
+Remove Channel
+==============
+
+Visit the URL
+
+ https://yoursite/removeme
+
+(replace 'yoursite' with the domain name of your $Projectname site).
+
+You will need to confirm your password and the channel you are currently logged into will be removed.
+
+This is irreversible.
+
+If you have identity clones on other sites this only removes the channel instance which exists
+on this site.
+
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/Schema-development.md b/sources/doc/Schema-development.md
new file mode 100644
index 00000000..e811bb8c
--- /dev/null
+++ b/sources/doc/Schema-development.md
@@ -0,0 +1,81 @@
+Red development - a guide to the schema system
+==============================================
+
+
+A schema, in a nutshell, is a collection of settings for a bunch of variables to define
+certain elements of a theme. A schema is loaded as though it were part of config.php
+and has access to all the same information. Importantly, this means it is identity aware,
+and can be used to do some interesting things. One could, for example, restrict options
+by service class, or present different options to different members.
+
+By default, we filter only by whether or not expert mode is enabled. If expert mode is
+enabled, all options are presented to the member. If it is not, only scheme, background
+image, font face, and iconset are available as choices.
+
+A schema is loaded *after* the member's personal settings. Therefore, to allow a member
+to overwrite a particular aspect of a schema you would use the following syntax:
+
+ if (! $foo)
+ $foo = 'bar';
+
+However, there are circumstances - particularly with positional elements - where it
+may be desirable (or necessary) to override a member's settings. In this case, the syntax
+is even simpler:
+
+ $foo = 'bar';
+
+Members will not thank you for this, however, so only use it when it is required.
+
+If no personal options are set, and no schema is selected, we will first try to load a schema
+with the file name "default.php". This file should never be included with a theme. If it
+is, merge conflicts will occur as people update their code. Rather, this should be defined
+by administrators on a site by site basis.
+default.php and default.css MUST be symlinks to existing scheme files.
+
+You schema does not need to - and should not - contain all of these values. Only the values
+that differ from the defaults should be listed. This gives you some very powerful options
+with very few lines of code.
+
+Note the options available differ with each theme. The options available with the Redbasic
+theme are as follows:
+
+* nav_colour
+ The colour of the navigation bar. Options are red, black and silver. Alternatively,
+ one can set $nav_bg_1, $nav_bg_2, $nav_bg_3 and $nav_bg_4 to provide gradient and
+ hover effects.
+* banner_colour
+ The font colour of the banner element. Accepts an RGB or Hex value.
+* bgcolour
+ Set the body background colour. Accepts an RGB or Hex value.
+* background_image
+ Sets a background image. Accepts a URL or path.
+* item_colour
+ Set the background colour of items. Accepts an RGB or Hex value.
+* item_opacity
+ Set the opacity of items. Accepts a value from 0.01 to 1
+* toolicon_colour
+ Set the colour of tool icons. Accepts an RGB or Hex value.
+* toolicon_activecolour
+ Set the colour of active or hovered icon tools.
+* font_size
+ Set the size of fonts in items and posts. Accepts px or em.
+* body_font_size
+ Sets the size of fonts at the body level. Accepts px or em.
+* font_colour
+ Sets the font colour. Accepts an RGB or Hex value.
+* radius
+ Set the radius of corners. Accepts a numeral, and is always in px.
+* shadow
+ Set the size of shadows shown with inline images. Accepts a numerical
+ value. Note shadows are not applied to smileys.
+* converse_width
+ Set the maximum width of the content region in px.
+* nav_min_opacity
+* top_photo
+* reply_photo
+
+If a your_schema_name.css file is found, the content of this file will be attached to the end of style.css.
+This gives the schem developer the possiblity to override any style component.
+
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/Tags-and-Mentions.md b/sources/doc/Tags-and-Mentions.md
new file mode 100644
index 00000000..84442dd7
--- /dev/null
+++ b/sources/doc/Tags-and-Mentions.md
@@ -0,0 +1,26 @@
+Tags and Mentions
+=================
+
+Like many other platforms, Red uses a special notation inside messages to indicate "tags" or contextual links to other entities.
+
+**Mentions**
+
+Channels are tagged by simply preceding their name with the @ character. Unless their system blocks unsolicited "mentions", the person tagged will likely receive a "Mention" post/activity or become a direct participant in the conversation in the case of public posts.
+
+When you start to mention somebody, it will create an auto-complete box to select from your immediate connections. Select one as appropriate. Some connections will be displayed in different colours. A light blue entry (using the default theme) indicates a channel which will redeliver to others if tagged. This is generally a conversation group or forum. But be aware that when tagged, the message will also go to anybody they choose, in addition to anybody you choose.
+
+**Private Mentions**
+
+If you wish to restrict a post to a single person or a number of people, you can do this by selecting channels or collections from the privacy tool. You can also just tag them with a privacy tag. A privacy tag is a name preceded by the two characters @! - and in addition to tagging these channels, will also change the privacy permissions of the post to include them (and perhaps restrict the post from "everybody" if this was the default). You can have more than one privacy tag, for instance @!bob and @!linda will send the post only to Bob and Linda (in addition to any recipients you selected with the privacy selector - if any).
+
+You may also tag public collections. When you create or edit a collection, there is a checkbox to allow the group members to be seen by others. If this box is checked for a collection and you tag (for instance) @!Friends - the post will be restricted to the Friends collection. Check that the collection is public before doing this - as there is no way to take back a post except to delete it. The collection name will appear in the post and will alert members of that collection that they are members of it.
+
+
+
+**Topical Tags**
+
+Topical tags are indicated by preceding the tag name with the # character. This will create a link in the post to a generalised site search for the term provided. For example, #cars will provide a search link for all posts mentioning 'cars' on your site. Topical tags are generally a minimum of three characters in length. Shorter search terms are not likely to yield any search results, although this depends on the database configuration. The same rules apply as with names that spaces within tags are represented by the underscore character. It is therefore not possible to create a tag whose target contains an underscore.
+
+Topical tags are also not linked if they are purely numeric, e.g. #1. If you wish to use a numerica hashtag, please add some descriptive text such as #2012-elections.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/TermsOfService.md b/sources/doc/TermsOfService.md
new file mode 100644
index 00000000..97e9881a
--- /dev/null
+++ b/sources/doc/TermsOfService.md
@@ -0,0 +1,5 @@
+Terms of Service
+================
+
+#include doc/SiteTOS.md;
+
diff --git a/sources/doc/Translations.md b/sources/doc/Translations.md
new file mode 100644
index 00000000..d0fe489f
--- /dev/null
+++ b/sources/doc/Translations.md
@@ -0,0 +1,93 @@
+Translating the $Projectname
+==========================
+
+Translation Process
+-------------------
+
+The strings used in the UI of Red is translated at [Transifex][1] and then
+included in the git repository at github. If you want to help with translation
+for any language, be it correcting terms or translating Red to a
+currently not supported language, please register an account at transifex.com
+and contact the Red translation team there.
+
+Translating Red is simple. Just use the online tool at transifex. If you
+don't want to deal with git & co. that is fine, we check the status of the
+translations regularly and import them into the source tree at github so that
+others can use them.
+
+We do not include every translation from transifex in the source tree to avoid
+a scattered and disturbed overall experience. As an uneducated guess we have a
+lower limit of 50% translated strings before we include the language. This
+limit is judging only by the amount of translated strings under the assumption
+that the most prominent strings for the UI will be translated first by a
+translation team. If you feel your translation useable before this limit,
+please contact us and we will probably include your teams work in the source
+tree.
+
+If you want to get your work into the source tree yourself, feel free to do so
+and contact us with and question that arises. The process is simple and
+Red ships with all the tools necessary.
+
+The location of the translated files in the source tree is
+ /view/LNG-CODE/
+where LNG-CODE is the language code used, e.g. de for German or fr for French.
+For the email templates (the *.tpl files) just place them into the directory
+and you are done. The translated strings come as a "messages.po" file from
+transifex which needs to be translated into the PHP file Red uses. To do
+so, place the file in the directory mentioned above and use the "po2php"
+utility from the util directory of your Red installation.
+
+Assuming you want to convert the German localization which is placed in
+view/de/messages.po you would do the following.
+
+1. Navigate at the command prompt to the base directory of your
+ Red installation
+
+2. Execute the po2php script, which will place the translation
+ in the strings.php file that is used by Red.
+
+ $> php util/po2php.php view/de/messages.po
+
+ The output of the script will be placed at view/de/strings.php where
+ froemdoca os expecting it, so you can test your translation mmediately.
+
+3. Visit your Red page to check if it still works in the language you
+ just translated. If not try to find the error, most likely PHP will give
+ you a hint in the log/warnings.about the error.
+
+ For debugging you can also try to "run" the file with PHP. This should
+ not give any output if the file is ok but might give a hint for
+ searching the bug in the file.
+
+ $> php view/de/strings.php
+
+4. commit the two files with a meaningful commit message to your git
+ repository, push it to your fork of the Red repository at github and
+ issue a pull request for that commit.
+
+Utilities
+---------
+
+Additional to the po2php script there are some more utilities for translation
+in the "util" directory of the Red source tree. If you only want to
+translate Red into another language you wont need any of these tools most
+likely but it gives you an idea how the translation process of Red
+works.
+
+For further information see the utils/README file.
+
+Known Problems
+--------------
+
+* Red uses the language setting of the visitors browser to determain the
+ language for the UI. Most of the time this works, but there are some known
+ quirks.
+* the early translations are based on the friendica translations, if you
+ some rough translations please let us know or fix them at Transifex.
+
+Links
+------
+[1]: http://www.transifex.com/projects/p/red-matrix/
+
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/Webpages.md b/sources/doc/Webpages.md
new file mode 100644
index 00000000..dafd3661
--- /dev/null
+++ b/sources/doc/Webpages.md
@@ -0,0 +1,16 @@
+Creating Webpages
+=================
+
+Red enables users to create static webpages. To activate this feature, enable the web pages feature in your Additional Features section.
+
+Once enabled, a new tab will appear on your channel page labelled "Webpages". Clicking this link will take you to the webpage editor. Here you can create a post using either BBCode or the rich text editor.
+
+Pages will be accessible at mydomain/page/username/pagelinktitle
+
+The "page link title" box allows a user to specify the "pagelinktitle" of this URL. If no page link title is set, we will set one for you automatically, using the message ID of the item.
+
+Beneath the page creation box, a list of existing pages will appear with an "edit" link. Clicking this will take you to an editor, similar to that of the post editor, where you can make changes to your webpages.
+
+If you are the admin of a site, you can specify a channel whose webpages we will use at key points around the site. Presently, the only place this is implemented is the home page. If you specify the channel "admin" and then the channel called "admin" creates a webpage called "home", we will display it's content on your websites home page. We expect this functionality to be extended to other areas in future.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/Widgets.md b/sources/doc/Widgets.md
new file mode 100644
index 00000000..5cc7eab2
--- /dev/null
+++ b/sources/doc/Widgets.md
@@ -0,0 +1,123 @@
+Core Widgets
+============
+
+Some/many of these widgets have restrictions which may restrict the type of page where they may appear or may require login
+
+
+* clock - displays the current time
+ * args: military (1 or 0) - use 24 hour time as opposed to AM/PM
+' . t('Randplace Settings') . '
'; + $s .= '';
+ $s .= '';
+ $s .= '';
+ $s .= '
';
+
+ /* provide a submit button */
+
+ $s .= '+ +* profile - displays a profile sidebar on pages which load profiles (pages with nickname in the URL) + +* tagcloud - display a tagcloud of webpage items + + * args: count - number of items to return (default 24) +
+ +* collections - collection selector for the current logged in channel + + * args: mode - one of "conversation", "group", "abook" depending on module +
+ +* suggestions - friend suggestions for the current logged on channel + +* follow - presents a text box for following another channel + +* notes - private notes area for the current logged in channel if private_notes feature is enabled + +* savedsearch - network/matrix search with save - must be logged in and savedsearch feature enabled + +* filer - select filed items from network/matrix stream - must be logged in + +* archive - date range selector for network and channel pages + * args: 'wall' - 1 or 0, limit to wall posts or network/matrix posts (default) +
+ +* fullprofile - same as profile currently + +* categories - categories filter (channel page) + +* tagcloud_wall - tagcloud for channel page only + * args: 'limit' - number of tags to return (default 50) +
+ +* catcloud_wall - tagcloud for channel page categories + * args: 'limit' - number of categories to return (default 50) +
+ +* affinity - affinity slider for network page - must be logged in + +* settings_menu - sidebar menu for settings page, must be logged in + +* mailmenu - sidebar menu for private message page - must be logged in + +* design_tools - design tools menu for webpage building pages, must be logged in + +* findpeople - tools to find other channels + +* photo_albums - list photo albums of the current page owner with a selector menu + +* vcard - mini profile sidebar for the person of interest (page owner, whatever) + +* dirsafemode - directory selection tool - only on directory pages + +* dirsort - directory selection tool - only on directory pages + +* dirtags - directory tool - only on directory pages + +* menu_preview - preview a menu - only on menu edit pages + +* chatroom_list - list of chatrooms for the page owner + +* bookmarkedchats - list of bookmarked chatrooms collected on this site for the current observer + +* suggestedchats - "interesting" chatrooms chosen for the current observer + +* item - displays a single webpage item by mid + * args: mid - message_id of webpage to display +
+ +* photo - display a single photo + * args: + * url - URL of photo, must be http or https + * zrl - use zid authenticated link + * style - CSS style string +
+ +* photo_rand - display a random photo from one of your photo albums. Photo permissions are honoured + * args: + * album - album name (very strongly recommended if you have lots of photos) + * scale - typically 0 (original size), 1 (640px), or 2 (320px) + * style - CSS style string + * channel_id - if not your own +
+ +* random_block - display a random block element from your webpage design tools collection. Permissions are honoured. + * args: + * contains - only return blocks which include the contains string in the block name + * channel_id - if not your own +
+ +* tasklist - provide a task or to-do list for the currently logged-in channel. + * args: + * all - display completed tasks if all is non-zero. +
+ + +Creating New Widgets +==================== + +If you want a widget named 'slugfish', create widget/slugfish.php containing + + + Connections. In the right column under "Developers," click the link to "Register an OAuth client application to use with this instance of StatusNet." This link may be found at your instance here: + +https://yourgnusocialinstance.org/settings/oauthapps + +Next, click the link to Register a new application. That brings up the new application form. Here's what to do on each field. + +Icon. I uploaded the $Projectname icon located at this link, after saving it to my computer: + +https://github.com/redmatrix/hubzilla/blob/master/images/rm-32.png + +Name. Give the application an appropriate name. I called mine hubzilla. You might prefer r2g. + +Description. Use this field to describe the purpose of the application. I put something to the effect of use for crossposting from $Projectname to GNUsocial. + + +Source URL. Put the main domain name of the Red site you're using. Don't forget to put the "s" in https://yourhubzillasite.com. If your Red installation is a subdomain, that would probably be called for. + +Organization. Since $Projectname is unorganized, I put that. If you use your installation for a group or business, that might be a good option. + +Homepage. If your group is using a subdomain, you probably want to put your main domain URI here. Since I'm on a hosted site, I put redmatrix.me. + +Callback URL. Leave blank. + +Type of application: select "desktop." + +Default access: select "Read-write." + +All fields except the callback URL must be filled in. + +Click on the save button. + +Then click on the icon or the name of the application for the information you'll need to insert over on $Projectname. + +***** + +Now open up a new tab or window and go to your $Projectname account, to Settings > Feature settings. Find the StatusNet Posting Settings. + +Insert the strings of numbers given on the GNUsocial site into the $Projectname fields for Consumer Key and Consumer Secret. + +The Base API Path (remember the trailing /) will be your instance domain, plus the /api/ following. It will probably look like this: + +https://yourgnusocialinstance.org/api/ + +In case of doubt check on your GNUsocial instance site in order to find the domain URLs of the Request token, Access token, and Authorization. It will be the first part of the domains, minus the /oauth/.... + +StatusNet application name: Insert the name you gave to the application over on the GNUsocial site. + +Click Submit. + +A button will appear for you to "Sign in to StatusNet." Click it and that will open a tab or window on the GNUsocial site for you to click "Allow." Once clicked and successfully authorized, a security code number will appear. Copy it and go back to the $Projectname app you just left and insert it in the field: "Copy the security code from StatusNet here." Click Submit. + +If successful, your information from the GNUsocial instance should appear in the $Projectname app. + +You now have several options to choose, if you desire, and those will need to be confirmed by clicking "Submit" also. The most interesting is "Send public postings to StatusNet by default." This option automatically sends any post of yours made in your $Projectname account to your GNUsocial instance. + +If you don't choose this option, you will have an option to send a post to your GNUsocial instance by first opening the post (by clicking in the post text area) and clicking on the lock icon next to the Share button. Select the GNUsocial icon made up of three colored dialog baloons. Close that window, then make your post. + +If all goes well, you have just cross-posted your $Projectname post to your account on a GNUsocial instance. + +#include doc/macros/addons_footer.bb; + diff --git a/sources/doc/api_functions.bb b/sources/doc/api_functions.bb new file mode 100644 index 00000000..e6cde3dc --- /dev/null +++ b/sources/doc/api_functions.bb @@ -0,0 +1,133 @@ +[b]Red Twitter API[/b] + +The "basic" Red web API is based on the Twitter API, as this provides instant compatibility with a huge number of third-party clients and applications without requiring any code changes on their part. It is also a super-set of the StatusNet version of the Twitter API, as this also has existing wide support. + +Red has a lot more capability that isn't exposed in the Twitter interfaces or where we are forced to "dumb-down" the API functions to work with the primitive Twitter/StatusNet communications and privacy model. So we plan to extend the Twitter API in ways that will allow Red-specific clients to make full use of Red features without being crippled. + +A dedicated Red API is also being developed to work with native data structures and permissions and which do not require translating to different privacy and permission models and storage formats. This will be described in other documents. The prefix for all of the native endpoints is 'api/red'. + +Red provides multiple channels accesible via the same login account. With Red, any API function which requires authentication will accept a parameter &channel={channel_nickname} - and will select that channel and make it current before executing the API command. By default, the default channel associated with an account is selected. + +Red also provides an extended permission model. In the absence of any Red specific API calls to set permissions, they will be set to the default permissions settings which are associated with the current channel. + +Red will probably never be able to support the Twitter 'api/friendships' functions fully because Red is not a social network and has no concept of "friendships" - it only recognises permissions to do stuff (or not do stuff as the case may be). + +Legend: T= Twitter, S= StatusNet, F= Friendica, R= Red, ()=Not yet working, J= JSON only (XML formats deprecated) + +Twitter API compatible functions: + + api/account/verify_credentials T,S,F,R + api/statuses/update T,S,F,R + api/users/show T,S,F,R + api/statuses/home_timeline T,S,F,R + api/statuses/friends_timeline T,S,F,R + api/statuses/public_timeline T,S,F,R + api/statuses/show T,S,F,R + api/statuses/retweet T,S,F,R + api/statuses/destroy T,S,F,(R) + api/statuses/mentions T,S,F,(R) + api/statuses/replies T,S,F,(R) + api/statuses/user_timeline T,S,F,(R) + api/favorites T,S,F,R + api/account/rate_limit_status T,S,F,R + api/help/test T,S,F,R + api/statuses/friends T,S,F,R + api/statuses/followers T,S,F,R + api/friends/ids T,S,F,R + api/followers/ids T,S,F,R + api/direct_messages/new T,S,F,R + api/direct_messages/conversation T,S,F,R + api/direct_messages/all T,S,F,R + api/direct_messages/sent T,S,F,R + api/direct_messages T,S,F,R + api/oauth/request_token T,S,F,R + api/oauth/access_token T,S,F,R + api/favorites T,S,R + api/favorites/create T,S,R + api/favorites/destroy T,S,R + +Twitter API functions supported by StatusNet but not currently by Friendica or Red + + api/statuses/retweets_of_me T,S + api/friendships/create T,S + api/friendships/destroy T,S + api/friendships/exists T,S + api/friendships/show T,S + api/account/update_location T,S + api/account/update_profile_background_image T,S + api/account/update_profile_image T,S + api/blocks/create T,S + api/blocks/destroy T,S + +Twitter API functions not currently supported by StatusNet + + api/statuses/retweeted_to_me T + api/statuses/retweeted_by_me T + api/direct_messages/destroy T + api/account/end_session T,(R) + api/account/update_delivery_device T + api/notifications/follow T + api/notifications/leave T + api/blocks/exists T + api/blocks/blocking T + api/lists T + +Statusnet compatible extensions to the Twitter API supported in both Friendica and Red + + api/statusnet/version S,F,R + api/statusnet/config S,F,R + +Friendica API extensions to the Twitter API supported in both Friendica and Red + + api/statuses/mediap F,R + +Red specific API extensions to the Twitter API not supported in Friendica + + api/account/logout R + api/export/basic R,J + api/friendica/config R + api/red/config R + api/friendica/version R + + api/red/version R + + api/red/channel/export/basic R,J + api/red/channel/stream R,J (currently post only) + api/red/albums R,J + api/red/photos R,J (option album=xxxx) + +Red proposed API extensions to the Twitter API + + api/statuses/edit (R),J + api/statuses/permissions (R),J + api/statuses/permissions/update (R),J + api/statuses/ids (R),J # search for existing message_id before importing a foreign post + api/files/show (R),J + api/files/destroy (R),J + api/files/update (R),J + api/files/permissions (R),J + api/files/permissions/update (R),J + api/pages/show (R),J + api/pages/destroy (R),J + api/pages/update (R),J + api/pages/permissions (R),J + api/pages/permissions/update (R),J + api/events/show (R),J + api/events/update (R),J + api/events/permissions (R),J + api/events/permissions/update (R),J + api/events/destroy (R),J + api/photos/show (R),J + api/photos/update (R),J + api/photos/permissions (R),J + api/photos/permissions/update (R),J + api/albums/destroy (R),J + api/albums/show (R),J + api/albums/update (R),J + api/albums/permissions (R),J + api/albums/permissions/update (R),J + api/albums/destroy (R),J + api/friends/permissions (R),J + +#include doc/macros/main_footer.bb; + diff --git a/sources/doc/api_posting.bb b/sources/doc/api_posting.bb new file mode 100644 index 00000000..fa955826 --- /dev/null +++ b/sources/doc/api_posting.bb @@ -0,0 +1,23 @@ +[b][size=xx-large]Posting to the Matrix via the API[/size][/b] + +The API allows you to post to the red# by HTTP POST request. Below you see an example using the command line tool cURL: + +[code]curl -ssl -u [color=blue]$E-Mail[/color]:[color=blue]$Password[/color] -d "[color=blue]$Parameters[/color]" [url][observer=1][observer.baseurl][/observer][observer=0]example.com[/observer]/api/statuses/update +[/url][/code] +[table][tr][td]$E-Mail:[/td][td]The E-Mail Adress you use to login[/td][/tr] +[tr][td]$Password:[/td][td]The Password you use to login[/td][/tr] +[tr][td]$Parameters:[/td][td]That's the interesting part, here you insert the content you want to send using the following parameters:[/td][/tr][/table] + +[ul] +[*]title: the title of the posting +[*]channel: the channel you want to post to +[*]category: a comma-seperated list of categories for the posting +[*]status: the content of the posting, formatted with BBCode + OR +[*]htmlstatus:the content of the posting, formatted in HTML. +[/ul] + + +Instead of calling [observer=1][observer.baseurl][/observer][observer=0]example.com[/observer]/api/statuses/update which returns a json (you could also add .json on the end to clarify) output, you can use [observer.baseurl]/api/statuses/update.xml to get an xml formatted return. + +Instead of Basic HTTP Authentification you could also use oAuth. diff --git a/sources/doc/bbcode.html b/sources/doc/bbcode.html new file mode 100644 index 00000000..4fe47842 --- /dev/null +++ b/sources/doc/bbcode.html @@ -0,0 +1,88 @@ +
BBcode reference
+
+
+
+ +
You can make lists with:
+
[ul]
[*] First list element
[*] Second list element
[/ul]
Will render something like:
+
+
There's also:
+
+
Tables? Yes!
[table border=1]
[tr]
[th]Tables now[/th]
[/tr]
[tr]
[td]Have headers[/td]
[/tr]
[/table]
All sizes,
From the [size=xx-small] - xx-small.
To the [size=xx-large] - xx-large.
To fit exactly 20px use [size=20].
+ +
+
+
+
+
diff --git a/sources/doc/campaign.bb b/sources/doc/campaign.bb
new file mode 100644
index 00000000..48f28f0c
--- /dev/null
+++ b/sources/doc/campaign.bb
@@ -0,0 +1,237 @@
+[b]Initial Indiegg pitch[/b]
+
+[b][color= grey][size=20]What have we done, and what we hope to achieve[/size][/color][/b]
+
+[b][color= grey][size=18]Single-click sign on, nomadic identity, censorship-resistance, privacy, self-hosting[/size][/color][/b]
+
+We started the $Projectname project by asking ourselves a few questions:
+
+- Imagine if it was possible to just access the content of different web sites, without the need to enter usernames and passwords for every site. Such a feature would permit Single-Click user identification: the ability to access sites simply by clicking on links to remote sites.
+Authentication just happens automagically behind the scenes. Forget about remembering multiple user names with multiple passwords when accessing different sites online.
+
+We liked this idea and went ahead with coding it immediately. Today, single-click sign is in alpha state. It needs more love, which means a solid three months of full-time development efforts.
+
+- Think of your Facebook, Twitter, WordPress, or any other website where you currently have an account. Now imagine being able to clone your account, to make an exact duplicate of it (with all of your friends, posts and settings), then export your cloned account into another server that is part of this communication network. After you're done, both of your accounts are synced from the time they were cloned. It doesn't matter where you log in (at your original location, or where you imported your clone). You see the same content, the same friends, posts, and account settings.
+At that point, it is more appropriate to call your account an identity that is nomadic (it is not tied to one home, unless you choose to do so!).
+It's 2013, our online presence no longer has to be tied to a single server, domain name or IP address. We should be able to clone and import our identities to other servers. In such a network, it should only matter who you are, not where you are.
+
+We're very intrigued by the possibilities nomadic identities open up for freedom, censorship-resistance, and identity resilience. Consider the following scenarios:
+
+ -- Should a repressive government or corporation decide to delete your account, your cloned identity lives on, because it is located on another server, across the world, which is part of the same communication network. You can't be silenced!
+
+ -- What if there is a server meltdown, and your identity goes off line. No problem, you log into your clone and all is good.
+
+ -- Your server administrator can no longer afford to keep paying to support a free service (a labor love and principle, which all of us have participating in as system administrators of Friendica sites!). She notifies you that you must clone your account before the shutoff date. Rather than loose all your friends, and start from scratch by creating a new identity somewhere, you clone and move to another server.
+We feel this is especially helpful for the free web, where administrators of FOSS community sites are often faced with difficult financial decisions. Since many of them rely on donations, sometimes servers have to be taken offline, when costs become prohibitive for the brave DIY souls running those server. Nomadic identities should relieve some of the pressures associated with such situations.
+
+At the same time, we are also thinking of solutions that would make it possible for people running Red hubs to be financially sustainable. To that end, we're starting to implement service classes in our code, which would allow administrators to structure paid levels of service, if they choose to do so.
+
+Today, nomadic identity is currently in alpha state. It also needs more love, which means a solid three months of full-time development efforts.
+
+- Imagine a social network that is censorship-resistant, and privacy-respecting by design. It is not controlled by one mega-corporation, and where users cannot be easily censored by oppressive governments. So, in addition to nomadic identities, we are talking about decentralization, open source, freely software, that can run on any hardware that supports a database and a modern web browser. And we mean "any hardware", from a self-hosted $35 Raspberry Pi, to the very latest Intel Xeon and AMD Bulldozer-powered server behemoths.
+
+We've realized that privacy requires full control over content. We should be able to delete, backup and download all of our content, as well as associated account/identity information. To this end, we have already implemented the initial version of account export and backup.
+
+Concerned about pages and pages of posts from months and years past? The solution should be simple: visit your settings page, specify that all content older than 7 days, with the exception of starred posts, should be automatically deleted. Done, the clutter is gone! (Consider also the privacy and anti-mass surveillance implications of this feature. PRISM disclosures have hinted that three-letter spying agencies around the world are recording all internet traffic and storing it for a few days at a time. We feel that automatic post expiration becomes a rather useful feature in this context, and implementing it is one of our near future priorities.)
+
+[b][color= grey][size=18]The Affinity Slider and Access Control Lists[/size][/color][/b]
+
+- What if the permissions and access control lists that help secure modern operating systems were extended into a communication network that lived on the internet? This means somebody could log into this network from their home site, and with the simple click of a few buttons dynamically sort who can have access to their online content on a very fine level: from restricting others from seeing your latest blog post, to sharing your bookmarks with the world.
+
+We've coded the initial version of such a new feature. It is called the "Affinity Slider", and in our very-alpha user interface it looks like this.
+[img]https://friendicared.net/photo/b07b0262e3146325508b81a9d1ae4a1e-0.png[/img]
+
+{INSERT SCREENSHOT OF A MATRIX PAGE}
+
+Think of it as an easy way to filter content that you see, based on the degree of "closeness" to you. Move the slider to Friends, and only content coming from contacts you've tagged as friends is displayed on your home page. Uncluttering thousands of contacts, friends, RSS feeds, and other content should be a basic feature of modern communication on the web, but not at the expense of ease of use.
+
+In addition to the Affinity Slider, we also have the ACL (Access Control List). Say you want to share something with only 5 of your contacts (a blog, two friends from college, and two forums). You click on the padlock, choose the recipients, and that's it. Only those identities will recieve their posts. Furthermore, the post will be encrypted via PKI (pulic key encryption) to help maintain privacy. In the age of PRISM, we don't know all the details on what's safe out there, but we still think that privacy by design should be automatically present, invisible to the user, and easy to use.
+Attaching permissions to any data that lives on this network, potentially solves a great many headaches, while achieving simplicity in communication.
+
+Think of it this way: the internet is nothing, but a bunch of permissions and a folder of data. You, the user controls the permissions and thus the data that is relevant to you.
+
+[b][color= grey][size=20]The Matrix is Born![/size][/color][/b]
+
+After asking and striving to answer a number of such questions, we realized that we were imagining a general purpose communication network with a number of unique, and potentially game-changing, features. We called it the $Projectname and started thinking of it as an over-lay on top of the internet as it exists today; an operating system re-invented as a communication network, with its own permissions, access control lists, protocol, connectors to others services, and open-ended possibilities via its API. The sum of the matrix is greater than it's parts. We're not building website, but a way for websites to link together and grow into something that is unique and ever-changing, with autonomy and privacy.
+
+It's a lot of work, for anyone. So far, we've got a team of a handful of volunteers, code geeks, brave early adopters, system administrators and other good people, willing to give the project a shot. We're motivated by our commitment to a free web, where privacy is built-in, and corporations don't have a stranglehold on our daily communication.
+
+We need your help to finish it and release it to the world!
+
+[b][color= grey][size=20]What have we written so far[/size][/color][/b]
+
+As of the today, the $Projectname is in developer preview (alpha) state. It is not ready for everyday use, but some of the initial set of core features are implemented (again, in alpha state). These include:
+
+- Zot, the protocol powering the matrix
+- Single-signon logins.
+- Nomadic identities
+- Basic content manipulation: creation, deletion, rudimentary handling of photos, and media files
+- A bare-bones outline of the API and user documentation.
+
+
+[b][color= grey][size=20]Our TO-DO List[/size][/color][/b]
+
+However, in addition to finishing and polishing the above, there are a number of features that have to implemented to make the $Projectname ready for daily use. If we meet our fundraising goal, we hope to dive into the following road map, by order of priority:
+
+- A professionally designed user interface (UI), interface that is adaptive to any user level, from end users who want to use the Matrix as a social network, to tinkerers who will put together a customized blog using Comanche, to hackers who will develop and extend the matrix using a built-in code editor, that hooks to the API and the git.
+
+- Comanche, our new markup language, similar to BBCode, with which to create elaborate and complex web pages by assembling them from a series of components - some of which are pre-built and others which can be defined on the fly. You can read more about it on our github wiki: https://github.com/friendica/red/wiki/Comanche
+
+- A unique help system that lives in the matrix, but is not based on the principles of a search engine. We have some interesting ideas about decentralizing help documentation, without going down the road of distributed search engines. Here's a hint: We shouldn't be searching at all, we should just be filtering what's already there in new, and cunning ways.
+
+- An appropriate logo, along with professionally done documentation system, both for our API, as well as users.
+
+- WordPress-like single button software upgrades
+
+- A built-in development environment, using an integrated web-based code editor such as Ace9
+
+[b][color= grey][size=20]What will the money be used for[/size][/color][/b]
+
+If we raise our targeted amount of funds, we plan to use it as follows:
+
+1) Fund 6 months {OR WHATEVER} of full time work for our current core developers, Mike, Thomas, and Tobias {ANYONE ELSE?]
+
+2) Pay a professional web developer to design an kick ass reference theme, along with a project logo.
+
+3) {WHAT ELSE?}
+
+[b][color= grey][size=20]Deadlines[/size][/color][/b]
+
+[b]March, 2014: $Projectname Beta with the following features[/b]
+
+- {LIST FEATURES}
+
+[b][color= grey][size=20]Who We Are[/size][/color][/b]
+
+Mike: {FILL IN BIO, reference Friendica, etc.}
+
+Thomas: {bio blurb}
+
+Tobias: {bio blurb}
+
+Arto: {documentation, etc.}
+
+{WHO ELSE? WE NEED A TEAM, AT LEAST 3-4 PEOPLE}
+
+[b][color= grey][size=20]What Do I Get as a Supporter?[/size][/color][/b]
+
+Our ability to reach 1.0 stable release depends on your generosity and support. We appreciate your help, regardless of the amount! Here's what we're thinking as far as different contribution levels go:
+
+[b]$1: {CATCHY TAGLINE}[/b]
+
+We'll list your name on our initial supporters list, a Hall of Fame of the matrix!
+
+[b]$5:[/b]
+
+[b]$10: [/b]
+
+[b]$16: [/b]
+
+You get one of your $Projectname t-shirts, as well as our undying gratitude.
+
+[b]$32: [/b]
+
+[b]$64 [/b]
+
+[b]128 [/b]
+
+[b]$256: [/b]
+
+[b]$512: [/b]
+
+[b]$1024 [/b]
+
+[b]$2048[/b]
+
+Each contributor at this level gets their own $Projectname virtual private server, installed, hosted and supported by us for a period of 1 year.
+
+[b][color= grey][size=20]Why are we so excited about the $Projectname?[/size][/color][/b]
+
+{SOMETHING ABOUT THE POTENTIAL IMPACT OF RED, ITS INNOVATIONS, ETC>
+
+[b][color= grey][size=20]Other Ways to Help[/size][/color][/b]
+
+We're a handful of volunteers, and we understand that not everyone can contribute by donating money. There are many other ways you can in getting the Matrix to version 1.0!
+
+First, you can checkout our source code on github: https://github.com/redmatrix/hubzilla
+
+Maybe you can dive in and help us out with some development.
+
+Second, you can install the current developer preview on a server and start compiling bug reports.
+
+Third, register at one of the public alpha Red hubs, and get a feel for what Red is trying to do!
+
+Perhaps you're good at writing and documenting stuff. Grab an account at one of the public alphas and give us a hand.
+
+[b][color= grey][size=20]Frequently Asked Questions[/size][/color][/b]
+
+[b]1. Is Red a social network?[/b]
+
+The $Projectname is not a social network. We're thinking of it as a general purpose communication network, with sharing, and public/private communications built into the matrix.
+
+[b]2. What is the difference between Red and Friendica?[/b]
+
+What's the difference between a passport, and a postcard?
+
+Friendica is really, really good at sending postcards. It can do all sorts of things with postcards. It can send them to your friends. It can send them to people you don't know. It can put them in an envelope and send them privately. It can run them through a photocopier and plaster them all over the internet. It can even take postcards in one language and convert them to many others so your friends who speak a different language can read them.
+
+What Friendica can't do, is wave a postcard at somebody and expect them to believe that holding this postcard prove you are who you say you are. Sure, if you've been sending somebody postcards, they might accept that it is you in the picture, but somebody who has never heard of you will not accept ownership of a postcard as proof of identity.
+
+The $Projectname offers a passport.
+
+You can still use it to send postcards. At the same time, when you wave your passport at somebody, they do accept it as proof of identity. No longer do you need to register at every single site you use. You already have an account - it's just not necessarily at our site - so we'll ask to see your passport instead.
+
+Once you've proven your identity, a Red hub lets you use our services, as though you'd registered with directly, and we'd verified your credentials as would have happened in the olden days. These resources can, of course, be anything at all.
+
+[b]2. Why did you choose PHP, instead of Ruby or Python?[/b]
+
+The reference implementation is in PHP. We chose PHP, because it is available everywhere, and is easily configurable. We understand the debates between proponents and opponents of PHP, Ruby and Python. Nothing prevents implementations of Zot and the matrix in those languages. In fact, people on the matrix have already started developing a version of Red in Python [SOURCE?], and there is talk about future implementations in C (aiming for blazing native performance) and Java. It's free and open source, so we feel it's only a matter of time, once Red is initially completed.
+
+[b]4. Other than PHP, what other technology does Red use?[/b]
+
+We use MySQL as our database (this include any forks such as, MariaDB or Percona), and any modern webserver (Apache, nginx, etc.).
+
+[b]5. How is the Affinity Slider different from Mozilla's Persona?[/b]
+{COMPLETE}
+
+[b]6. Does the $Projectname use encryption? Details please![/b]
+
+Yes, we do our best to use free and open source encryption libraries to help achieve privacy from general, mass surveillance.
+
+Communication between web browsers and Red hubs is encrypted using SSL certificates.
+
+Private communication on the matrix is protected by AES symmetric encryption, which is itself protected by RSA PKI (public key encryption). By default, we use AES-256-CBC, and our RSA keys are set to 4096-bits.
+
+For more info on our initial implementation of encrypted communication, check out our source code at Github: https://github.com/friendica/red/blob/master/include/crypto.php
+
+[b]7. What do you mean by decentralization? [/b]
+
+
+[b]8. Can I build my own website with in the $Projectname?[/b]
+
+Yes. The short explanation: We've got this spiffy idea we're calling "Comanche", which will allow non-programmers to build complete custom websites, and any such website will be able to connect to any other website or channel in the matrix. The goal of Comanche is to hide the technical complexities of communicating in the matrix, while encouraging people to use their creativity and put together their own unique presence on the matrix.
+
+The longer explanation: Comanche is a markup language, similar to bbcode, with which to create elaborate and complex web pages by assembling them from a series of components - some of which are pre-built and others which can be defined on the fly. Comanche uses a Page Description Language file (".pdl", pronounced "puddle") to create these pages. Bbcode is not a requirement; an XML PDL file could also be used. The tag delimiters would be different. Usage is the same.
+
+Additional information is available on our Github project wiki: https://github.com/friendica/red/wiki/Comanche
+
+Comanche is another one of our priorities for the next six months.
+
+[b]9. Where can I see some technical description of Zot?[/b]
+
+Our github wiki contains a number of high-level and technical descriptions of Zot, Comanche, and Red in general: https://github.com/friendica/red/wiki
+
+[b]10. What happens if you raise more than {TARGETED NUMBER}?[/b]
+
+Raising more than our initial goal of funds, will speed up our development efforts. More developers will be able to take time off from other jobs, and concentrate efforts on finishing Red.
+
+[b]11 Can I make a contribution via Bitcoin?[/b]
+
+{YES/NO}
+
+[b]12. I have additional Questions[/]
+
+Awesome. We'd be more than happy to chat. You can find us {HERE}
+
+#include doc/macros/main_footer.bb;
+
diff --git a/sources/doc/channels.bb b/sources/doc/channels.bb
new file mode 100644
index 00000000..ff044654
--- /dev/null
+++ b/sources/doc/channels.bb
@@ -0,0 +1,30 @@
+[b]Channels[/b]
+
+Channels are simply collections of content stored in one place. A channel can represent anything. It could represent you, a website, a forum, photo albums, anything. For most people, their first channel with be "Me".
+
+The most important features for a channel that represents "me" are:
+
+Secure and private "spam free" communications
+
+Identity and "single-signon" across the entire network
+
+Privacy controls and permissions which extend to the entire network
+
+Directory services (like a phone book)
+
+In short, a channel that represents yourself is "me, on the internet".
+
+You will be required to create your first channel as part of the sign up process. You can also create additonal channels from the "Select channel" link.
+
+You will be asked to provide a channel name, and a short nick name. For a channel that represents yourself, it is a good idea to use your real name here to ensure your friends can find you, and connect to your channel. The short nickname will be used to generate a "webbie". This is a bit like a username, and will look like an email address, taking the form nickname@domain. You should put a little thought into what you want to use here. Imagine somebody asking for your webbie and having to tell them it is "llamas-are_kewl.123". "llamasarecool" would be a much better choice.
+
+Once you have created your channel, you will be taken to the settings page, where you can configure your channel, and set your default permissions.
+
+Once you have done this, your channel is ready to use. At [observer=1][observer.url][/observer][observer=0]example.com/channel/username[/observer] you will find your channel "stream". This is where your recent activity will appear, in reverse chronological order. If you post in the box marked "share", the entry will appear at the top of your stream. You will also find links to all the other communication areas for this channel here. The "About" tab contains your "profile", the photos page contain photo albums, and the events page contains events share by both yourself and your contacts.
+
+The "Matrix" page contains all recent posts from across the matrix, again in reverse chronologial order. The exact posts that appear here depend largely on your permissions. At their most permissive, you will receive posts from complete strangers. At the other end of the scale, you may see posts from only your friends - or if you're feeling really anti-social, only your own posts.
+
+As mentioned at the start, many other kinds of channel are possible, however, the creation procedure is the same. The difference between channels lies primarily in the permissions assigned. For example, a channel for sharing documents with colleagues at work would probably want more permissive settings for "Can write to my "public" file storage" than a personal account. For more information, see the permissions section.
+
+#include doc/macros/main_footer.bb;
+
diff --git a/sources/doc/checking_account_quota_usage.bb b/sources/doc/checking_account_quota_usage.bb
new file mode 100644
index 00000000..ca7e070a
--- /dev/null
+++ b/sources/doc/checking_account_quota_usage.bb
@@ -0,0 +1,20 @@
+[b]Checking your account quota usage (service limits usage)[/b]
+
+Your hub might implement service class limits, assigning limits to the total size of file, photo, channels, top-level posts, etc., that can be created by an account holder for a specific service level.
+
+Here's how you can quickly check how much of your assigned quota you're currently using:
+
+[b]Check file storage quota levels[/b]
+Visit the following URL in your browser:
+[observer=1][observer.baseurl]/filestorage/[observer.webname][/observer]
+[observer=0]example.com/filestorage/username[/observer]
+
+[b]Check uploaded photos storage quota levels[/b]
+[observer=1][observer.baseurl]/photos/[observer.webname][/observer]
+[observer=0]example.com/photos/username[/observer]
+
+Example:
+[observer=1][observer.baseurl]/filestorage/[observer.webname][/observer]
+[observer=0]example.com/filestorage/username[/observer]
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/classRedmatrix_1_1Import_1_1Import-members.html b/sources/doc/classRedmatrix_1_1Import_1_1Import-members.html
new file mode 100644
index 00000000..d5e2f927
--- /dev/null
+++ b/sources/doc/classRedmatrix_1_1Import_1_1Import-members.html
@@ -0,0 +1,131 @@
+
+
+
+
+
+
++
-
+
- [b]bold[/b] - bold
+ - [i]italic[/i] - italic
+ - [u]underlined[/u] - underlined
+ - [s]strike[/s] -
strike
+ - [color=red]red[/color] - red
+ - [url=https://redmatrix.me]$Projectname[/url] $Projectname
+ - [img]https://redmatrix.me/images/default_profile_photos/rainbow_man/48.jpg[/img]
+ - [img float=left]https://redmatrix.me/images/default_profile_photos/rainbow_man/48.jpg[/img]
+ + - [img float=right]https://redmatrix.me/images/default_profile_photos/rainbow_man/48.jpg[/img]
+ + - [code]code[/code]
code
+ - [quote]quote[/quote]
quote
+ - [quote=Author]Author? Me? No, no, no...[/quote]
Author wrote:Author? Me? No, no, no...
+ - [nobb] may be used to escape bbcode.
+ +
You can make lists with:
+
-
+
- [list]
+ - [list=1]
+ - [list=i]
+ - [list=I]
+ - [list=a]
+ - [list=A]
+ - [ul]
+ - [ol] + +
[ul]
[*] First list element
[*] Second list element
[/ul]
Will render something like:
+
-
+
- First list element
+ - Second list element
+
There's also:
+
-
+
- [hr]
+ - [video]video URL[/video]
+ - [audio]audio URL[/audio]
+ - [table]
+ - [th]
+ - [td]
+ - [tr]
+ - [center]
+ - [font=courier]some text[/font] some text
+
+
Tables? Yes!
[table border=1]
[tr]
[th]Tables now[/th]
[/tr]
[tr]
[td]Have headers[/td]
[/tr]
[/table]
| Tables now |
|---|
| Have headers |
All sizes,
From the [size=xx-small] - xx-small.
To the [size=xx-large] - xx-large.
To fit exactly 20px use [size=20].
+ +
$Projectname specific codes
+-
+
- [©] © This works for many HTML entities +
- [zrl]https://redmatrix.me[/zrl] Magic-auth version of [url] tag +
- [zmg]https://redmatrix.me/some/photo.jpg[/zmg] Magic-auth version of [img] tag
- [observer=1]Text to display if observer is authenticated in the matrix[/observer] +
- [observer=0]Text to display if observer is not authenticated in the matrix[/observer] +
- [observer.baseurl] website of observer +
- [observer.url] channel URL of observer +
- [observer.name] name of observer +
- [observer.address] address (zot-id) of observer +
- [observer.photo] profile photo of observer
- [spoiler] for hiding spoilers
- [rpost=title]Text to post[/rpost] The observer will be returned to their home hub to enter a post with the specified title and body. Both are optional +
- [qr]text to post[/qr] - create a QR code. +
- [toc] - create a table of content in a webpage. Please refer to the original jquery toc to get more explanations.
+
-
+
- Optional param: 'data-toc'. If ommited the default is 'body' +
- Optional param: 'data-toc-headings'. If ommited the default is 'h1,h2,h3' +
- Full example: [toc data-toc='div.page-body' data-toc-headings='h1,h2'] +
+
+
These require a suitable map plugin/addon such as openstreetmap or else the result will be blank
+-
+
- [map] Generate an inline map using the current browser coordinates of the poster, if browser location is enabled
+ - [map=latitude,longitude] Generate a map using global coordinates.
+ - [map]Place Name[/map] Generate a map for a given named location. The first matching location is returned. For instance "Sydney" will usually return Sydney, Australia and not Sydney, Nova Scotia, Canada unless the more precise location is specified. It is highly recommended to use the post preview utility to ensure you have the correct location before submitting the post.
+
+
+
+
+
+
+
+
+
+
+
+
+  |
+
+ The Hubzilla
+
+ |
+
+
+
+-
+
- Main Page +
- Related Pages +
- Namespaces +
- Classes +
- Files +
-
+ + ++
+
+
+ 
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/sources/doc/classRedmatrix_1_1Import_1_1Import.html b/sources/doc/classRedmatrix_1_1Import_1_1Import.html
new file mode 100644
index 00000000..9a7128d6
--- /dev/null
+++ b/sources/doc/classRedmatrix_1_1Import_1_1Import.html
@@ -0,0 +1,446 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Hubzilla\Import\Import Member List
+
+
+
+This is the complete list of members for Hubzilla\Import\Import, including all inherited members.
+| $credentials | Hubzilla\Import\Import | private |
| $itemlist | Hubzilla\Import\Import | protected |
| $items | Hubzilla\Import\Import | protected |
| $src_items | Hubzilla\Import\Import | protected |
| convert_child($child) | Hubzilla\Import\Import | |
| convert_item($item_ident) | Hubzilla\Import\Import | |
| convert_taxonomy($item_ident) | Hubzilla\Import\Import | |
| get_children($item_ident) | Hubzilla\Import\Import | |
| get_credentials() | Hubzilla\Import\Import | |
| get_item($item_ident) | Hubzilla\Import\Import | |
| get_item_ident($item) | Hubzilla\Import\Import | |
| get_itemlist() | Hubzilla\Import\Import | |
| get_taxonomy($item_ident) | Hubzilla\Import\Import | |
| run() | Hubzilla\Import\Import | |
| store($item, $update=false) | Hubzilla\Import\Import |
+
+
+
+
+
+
+
+
+
+
+
+ |
+
+ The Hubzilla
+
+ |
+
+
+
+-
+
- Main Page +
- Related Pages +
- Namespaces +
- Classes +
- Files +
-
+ + ++
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/sources/doc/cloud.bb b/sources/doc/cloud.bb
new file mode 100644
index 00000000..20498e6a
--- /dev/null
+++ b/sources/doc/cloud.bb
@@ -0,0 +1,27 @@
+[b]Personal Cloud Storage[/b]
+
+The $Projectname provides an ability to store privately and/or share arbitrary files with friends.
+
+You may either upload files from your computer into your storage area, or copy them directly from the operating system using the WebDAV protocol.
+
+On many public servers there may be limits on disk usage.
+
+[b]File Attachments[/b]
+
+The quickest and easiest way to share files is through file attachments. In the row of icons below the status post editor is a tool to upload attachments. Click the tool, select a file and submit. After the file is uploaded, you will see an attachment code placed inside the text region. Do not edit this line or it may break the ability for your friends to see the attachment. You can use the post permissions dialogue box or privacy hashtags to restrict the visibility of the file - which will be set to match the permissions of the post your are sending.
+
+To delete attachments or change the permissions on the stored files, visit [observer.baseurl]/filestorage/{{username}}" replacing {{username}} with the nickname you provided during channel creation.
+
+[b]Web Access[/b]
+
+Your files are visible on the web at the location "cloud/{{username}}" to anybody who is allowed to view them. If the viewer has sufficient privileges, they may also have the ability to create new files and folders/directories.
+
+[b]WebDAV access[/b]
+
+See: [zrl=[baseurl]/help/cloud_desktop_clients]Cloud Desktop Clients[/zrl]
+
+[b]Permissions[/b]
+
+When using WebDAV, the file is created with your channel's default file permissions and this cannot be changed from within the operating system. It also may not be as restrictive as you would like. What we've found is that the preferred method of making files private is to first create folders or directories; then visit "filestorage/{{username}}"; select the directory and change the permissions. Do this before you put anything into the directory. The directory permissions take precedence so you can then put files or other folders into that container and they will be protected from unwanted viewers by the directory permissions. It is common for folks to create a "personal" or "private" folder which is restricted to themselves. You can use this as a personal cloud to store anything from anywhere on the web or any computer and it is protected from others. You might also create folders for "family" and "friends" with permission granted to appropriate collections of channels.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/cloud_desktop_clients.bb b/sources/doc/cloud_desktop_clients.bb
new file mode 100644
index 00000000..2f099527
--- /dev/null
+++ b/sources/doc/cloud_desktop_clients.bb
@@ -0,0 +1,21 @@
+[b]Cloud Desktop Clients[/b]
+
+[b]Windows Clients[/b]
+
+[li][zrl=[baseurl]/help/dav_windows]Windows Internal Client[/zrl][/li]
+
+
+[b]Linux Clients[/b]
+
+[li][zrl=[baseurl]/help/dav_mount]Command Line as a Filesystem[/zrl][/li]
+[li][zrl=[baseurl]/help/dav_dolphin]Dolphin[/zrl][/li]
+[li][zrl=[baseurl]/help/dav_konqueror]Konqueror[/zrl][/li]
+[li][zrl=[baseurl]/help/dav_nautilus]Nautilus[/zrl][/li]
+[li][zrl=[baseurl]/help/dav_nemo]Nemo[/zrl][/li]
+
+
+[b]Server Notes[/b]
+
+Note: There have been reported issues with clients that use "chunked transfer encoding", which includes Apple iOS services, and also the "AnyClient" and "CyberDuck" tools. These work fine for downloads, but uploads often end up with files of zero size. This is caused by an incorrect implemention of chunked encoding in some current FCGI (fast-cgi) implementations. Apache running with PHP as a module does not have these issues, but when running under FCGI you may need to use alternative clients or use the web uploader. At the time of this writing the issue has been open and no updates provided for at least a year. If you encounter zero size files with other clients, please check the client notes; as there are occasional configuration issues which can also produce these symptoms.
+
+#include doc/macros/cloud_footer.bb;
diff --git a/sources/doc/comanche.bb b/sources/doc/comanche.bb
new file mode 100644
index 00000000..2eaa15de
--- /dev/null
+++ b/sources/doc/comanche.bb
@@ -0,0 +1,220 @@
+[b]Comanche Page Description Language[/b]
+
+Comanche is a markup language similar to bbcode with which to create elaborate and complex web pages by assembling them from a series of components - some of which are pre-built and others which can be defined on the fly. Comanche uses a Page Decription Language to create these pages.
+
+Comanche primarily chooses what content will appear in various regions of the page. The various regions have names and these names can change depending on what layout template you choose.
+
+[b]Page Templates[/b]
+Currently there are five layout templates, unless your site provides additional layouts.
+
+[code]
+ [b]default[/b]
+ The default template defines a "nav" region across the top, "aside" as a fixed width sidebar,
+ "content" for the main content region, and "footer" for a page footer.
+
+
+ [b]full[/b]
+ The full template defines the same as the default template with the exception that there is no "aside" region.
+
+
+ [b]choklet[/b]
+ The choklet template provides a number of fluid layout styles which can be specified by flavour:
+
+ (default flavour) - a two column layout similar to the "default" template, but more fluid
+ bannertwo - a two column layout with a banner region, compatible with the "default" template on small displays
+ three - three column layout (adds a "right_aside" region to the default template)
+ edgestwo - two column layout with fixed side margins
+ edgesthree - three column layout with fixed side margins
+ full - three column layout with fixed side margins and adds a "header" region beneath the navigation bar
+
+ [b]redable[/b]
+ A template for reading longer texts. Three columns: aside, content and right_aside.
+ For maximum readability it is advised to only use the middle content column.
+
+ [b]zen[/b]
+ Gives you the freedom to do everything yourself. Just a blank page with a content region.
+
+[/code]
+
+To choose a layout template, use the 'template' tag.
+
+[code]
+ [template]full[/template]
+
+[/code]
+
+To choose the "choklet" template with the "three" flavour:
+
+[code]
+ [template=three]choklet[/template]
+
+[/code]
+
+The default template will be used if no other template is specified. The template can use any names it desires for content regions. You will be using 'region' tags to decide what content to place in the respective regions.
+
+Three "macros" have been defined for your use.
+[code]
+ $htmlhead - replaced with the site head content.
+ $nav - replaced with the site navigation bar content.
+ $content - replaced with the main page content.
+
+[/code]
+
+By default, $nav is placed in the "nav" page region and $content is placed in the "content" region. You only need to use these macros if you wish to re-arrange where these items appear, either to change the order or to move them to other regions.
+
+
+To select a theme for your page, use the 'theme' tag.
+[code]
+ [theme]apw[/theme]
+
+[/code]
+This will select the theme named "apw". By default your channel's preferred theme will be used.
+
+[code]
+ [theme=passion]apw[/theme]
+
+[/code]
+This will select the theme named "apw" and select the "passion" schema (theme variant).
+
+
+[b]Regions[/b]
+Each region has a name, as noted above. You will specify the region of interest using a 'region' tag, which includes the name. Any content you wish placed in this region should be placed between the opening region tag and the closing tag.
+
+[code]
+ [region=htmlhead]....content goes here....[/region]
+ [region=aside]....content goes here....[/region]
+ [region=nav]....content goes here....[/region]
+ [region=content]....content goes here....[/region]
+
+[/code]
+
+[b]CSS and Javascript[/b]
+We have the possibility to include javascript and css libraries in the htmlhead region. At present we make use of jquery (js), bootstrap (css/js) and foundation (css/js).
+This will overwrite the selected themes htmlhead.
+
+[code]
+ [region=htmlhead]
+ [css]bootstrap[/css]
+ [js]jquery[/js]
+ [js]bootstrap[/js]
+ [/region]
+
+[/code]
+
+[b]Menus and Blocks[/b]
+Your webpage creation tools allow you to create menus and blocks, in addition to page content. These provide a chunk of existing content to be placed in whatever regions and whatever order you specify. Each of these has a name which you define when the menu or block is created.
+
+[code]
+ [menu]mymenu[/menu]
+
+[/code]
+This places the menu called "mymenu" at this location on the page, which must be inside a region.
+
+[code]
+ [menu=horizontal]mymenu[/menu]
+
+[/code]
+This places the menu called "mymenu" at this location on the page, which must be inside a region. Additionally it applies the "horizontal" class to the menu. "horizontal" is defined in the redbasic theme. It may or may not be available in other themes.
+
+[code]
+ [menu][var=wrap]none[/var]mymenu[/menu]
+
+[/code]
+The variable [var=wrap]none[/var] in a block removes the wrapping div element from the menu.
+
+[code]
+ [block]contributors[/block]
+[/code]
+This places a block named "contributors" in this region.
+
+[code]
+ [block=someclass]contributors[/block]
+
+[/code]
+This places a block named "contributors" in this region. Additionally it applies the "someclass" class to the block. This replaces the default block classes "bblock widget".
+
+[code]
+ [block][var=wrap]none[/var]contributors[/block]
+
+[/code]
+The variable [var=wrap]none[/var] in a block removes the wrapping div element from the block.
+
+[b]Widgets[/b]
+Widgets are executable apps provided by the system which you can place on your page. Some widgets take arguments which allows you to tailor the widget to your purpose. (TODO: list available widgets and arguments). The base system provides
+
+[code]
+ profile - widget which duplicates the profile sidebar of your channel page. This widget takes no arguments
+ tagcloud - provides a tag cloud of categories
+ count - maximum number of category tags to list
+
+[/code]
+
+Widgets and arguments are specified with the 'widget' and 'var' tags.
+[code]
+ [widget=recent_visitors][var=count]24[/var][/widget]
+
+[/code]
+
+This loads the "recent_visitors" widget and supplies it with the argument "count" set to "24".
+
+[b]Comments[/b]
+The 'comment' tag is used to delimit comments. These comments will not appear on the rendered page.
+
+[code]
+ [comment]This is a comment[/comment]
+
+[/code]
+
+[b]Complex Example[/b]
+[code]
+ [comment]use an existing page template which provides a banner region plus 3 columns beneath it[/comment]
+
+ [template]3-column-with-header[/template]
+
+ [comment]Use the "darknight" theme[/comment]
+
+ [theme]darkknight[/theme]
+
+ [comment]Use the existing site navigation menu[/comment]
+
+ [region=nav]$nav[/region]
+
+ [region=side]
+
+ [comment]Use my chosen menu and a couple of widgets[/comment]
+
+ [menu]myfavouritemenu[/menu]
+
+ [widget=recent_visitors]
+ [var=count]24[/var]
+ [var=names_only]1[/var]
+ [/widget]
+
+ [widget=tagcloud][/widget]
+ [block]donate[/block]
+
+ [/region]
+
+
+
+ [region=middle]
+
+ [comment]Show the normal page content[/comment]
+
+ $content
+
+ [/region]
+
+
+
+ [region=right]
+
+ [comment]Show my condensed channel "wall" feed and allow interaction if the observer is allowed to interact[/comment]
+
+ [widget]channel[/widget]
+
+ [/region]
+
+[/code]
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/connecting_to_channels.bb b/sources/doc/connecting_to_channels.bb
new file mode 100644
index 00000000..be37eb25
--- /dev/null
+++ b/sources/doc/connecting_to_channels.bb
@@ -0,0 +1,19 @@
+[b]Connecting To Channels[/b]
+
+Connections in the $Projectname can take on a great many different meanings. But let's keep it simple, you want to be friends with somebody like you are familiar with from social networking. How do you do it?
+
+First, you need to find some channels to connect to. There are two primary ways of doing this. Firstly, setting the "Can send me their channel stream and posts" permission to "Anybody in this network" will bring posts from complete strangers to your matrix. This will give you a lot of public content and should hopefully help you find interesting, entertaing people, forums, and channels.
+
+The next thing you can do is look at the Directory. The directory is available on every $Projectname website which means searching from your own site will bring in results from the entire network. You can search by name, interest, location and keyword. This is incomplete, so we'll improve this paragraph later.
+
+To connect with other $Projectname channels:
+
+Visit their profile by clicking their photograph in the directory, matrix, or comments, and it will open their channel home page in the channel viewer. At the left hand side of the screen, you will usually see a link called "connect". Click it, and you're done. Depending on the settings of the channel you are connecting to, you may need to wait for them to approve your connection, but no further action is needed on your part. Once you've initiated the connection, you will be taken to the connection editor. This allows you to assign specific permissions for this channel. If you don't allow any permissions, communication will be very limited. There are some quick links which you can use to avoid setting individual permissions. To provide a social network environment, "Full Sharing" is recommended. You may review the settings that are applied with the quick links to ensure they are suitable for the channel you are connecting with and adjust if necessary. Then scroll to the bottom of the page and click "Submit".
+
+You may also connect with any channel by visiting the "Connections" page of your site or the Directory and typing their "webbie" into the "Add New Connection" field. Use this method if somebody tells you their webbie and you wish to connect with them. A webbie looks like an email address; for example "bob@example.com". The process is the same as connecting via the "Connect" button - you will then be taken to the connection editor to set permissions.
+
+[b]Premium Channels[/b]
+
+Some channels are designated "Premium Channels" and may require some action on your part before a connection can be established. The Connect button will for these channels will take you to a page which lists in detail what terms the channel owner has set. If the terms are accepted, the connection will then proceed normally. In some cases, such as with celebrities and world-reknowned publishers, this may involve payment. If you do not agree to the terms, the connection will not proceed, or it may proceed but with reduced permissions allowed on your interactions with that channel.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/connecting_to_channels.md b/sources/doc/connecting_to_channels.md
new file mode 100644
index 00000000..60834c24
--- /dev/null
+++ b/sources/doc/connecting_to_channels.md
@@ -0,0 +1,34 @@
+# Connecting To Channels #
+
+Connections in the $Projectname can take on a great many different meanings. But let's keep it simple, you want to be friends with somebody like you are familiar with from social networking. How do you do it?
+
+First, you need to find some channels to connect to. There are two primary ways of doing this. Firstly, setting the "Can send me their channel stream and posts" permission to "Anybody in this network" will bring posts from complete strangers to your matrix. This will give you a lot of public content and should hopefully help you find interesting, entertaing people, forums, and channels.
+
+The next thing you can do is look at the Directory. The directory is available on every $Projectname website which means searching from your own site will bring in results from the entire network. You can search by name, interest, location and keyword. This is incomplete, so we'll improve this paragraph later.
+
+To connect with other $Projectname channels:
+
+Visit their profile by clicking their photograph in the directory, matrix, or comments, and it will open their channel home page in the channel viewer. At the left hand side of the screen, you will usually see a link called "connect". Click it, and you're done. Depending on the settings of the channel you are connecting to, you may need to wait for them to approve your connection, but no further action is needed on your part. Once you've initiated the connection, you will be taken to the connection editor. This allows you to assign specific permissions for this channel. If you don't allow any permissions, communication will be very limited. There are some quick links which you can use to avoid setting individual permissions. To provide a social network environment, "Full Sharing" is recommended. You may review the settings that are applied with the quick links to ensure they are suitable for the channel you are connecting with and adjust if necessary. Then scroll to the bottom of the page and click "Submit".
+
+You may also connect with any channel by visiting the "Connections" page of your site or the Directory and typing their "webbie" into the "Add New Connection" field. Use this method if somebody tells you their webbie and you wish to connect with them. A webbie looks like an email address; for example "bob@example.com". The process is the same as connecting via the "Connect" button - you will then be taken to the connection editor to set permissions.
+
+## Block/Ignore/Archive/Hide channels ##
+
+Channels in your address book can have statuses such as *blocked*, *ignored*, *archived* and *hidden*. From your connections page you can see tabs that display the channels with those statuses. From your edit connection pages you can change the statuses of a channel.
+
+Here's their meaning:
+
+**Blocked:** the channel can't read your items regardless of permissions, nor can it write to your channel.
+
+**Ignored:** the channel can read your items if it has permission, but can't write to your channel.
+
+**Hidden:** the channel does not show up in your profile's connections list, noone can see you're connected, but beware they may still show up to your other connections, for example in post replies.
+
+**Archived:** if a channel can't be reached for 30 days, it is automatically marked as archived. This keeps all the data but stops polling the channel for new information and removes it from autocomplete. If later you learn the channel has come back online, you may manually unarchive it.
+
+
+## Premium Channels ##
+
+Some channels are designated "Premium Channels" and **may** require some action on your part before a connection can be established. The Connect button will for these channels will take you to a page which lists in detail what terms the channel owner has set. If the terms are accepted, the connection will then proceed normally. In some cases, such as with celebrities and world-reknowned publishers, this **may** involve payment. If you do not agree to the terms, the connection will not proceed, or it may proceed but with reduced permissions allowed on your interactions with that channel.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/credits.bb b/sources/doc/credits.bb
new file mode 100644
index 00000000..5459c7d7
--- /dev/null
+++ b/sources/doc/credits.bb
@@ -0,0 +1,75 @@
+[b]Credits[/b]
+
+Mike Macgirvin
+Fabio Comuni
+Simon L'nu
+marijus
+Tobias Diekershoff
+fabrixxm
+tommy tomson
+Simon
+zottel
+Christian Vogeley
+jeroenpraat
+Michael Vogel
+erik
+Zach Prezkuta
+Paolo T
+Michael Meer
+Michael
+Abinoam P. Marques Jr
+Tobias Hößl
+Alexander Kampmann
+Olaf Conradi
+Paolo Tacconi
+tobiasd
+Devlon Duthie
+Zvi ben Yaakov (a.k.a rdc)
+Alexandre Hannud Abdo
+Olivier Migeot
+Chris Case
+Klaus Weidenbach
+Michael Johnston
+olivierm
+Vasudev Kamath
+pixelroot
+Max Weller
+duthied
+Martin Schmitt
+Sebastian Egbers
+Erkan Yilmaz
+sasiflo
+Stefan Parviainen
+Haakon Meland Eriksen
+Oliver Hartmann (23n)
+Erik Lundin
+habeascodice
+sirius
+Charles
+Tony Baldwin
+Hauke Zuehl
+Keith Fernie
+Anne Walk
+toclimb
+Daniel Frank
+Matthew Exon
+Michal Supler
+Tobias Luther
+U-SOUND\mike
+mrjive
+nostupidzone
+tonnerkiller
+Antoine G
+Christian Drechsler
+Ludovic Grossard
+Stanislav Lechev [0xAF]
+aweiher
+bufalo1973
+dsp1986
+felixgilles
+ike
+maase2
+mycocham
+ndurchx
+pafcu
+Simó Albert i Beltran
diff --git a/sources/doc/database.bb b/sources/doc/database.bb
new file mode 100644
index 00000000..fe193cf7
--- /dev/null
+++ b/sources/doc/database.bb
@@ -0,0 +1,66 @@
+[h2]Database Tables[/h2]
+[table]
+[tr][th]Table[/th][th]Description[/th][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_abook]abook[/zrl][/td][td]connections of local channels[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_account]account[/zrl][/td][td]service provider account[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_addon]addon[/zrl][/td][td]registered plugins[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_app]app[/zrl][/td][td]personal app data[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_attach]attach[/zrl][/td][td]file attachments[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_auth_codes]auth_codes[/zrl][/td][td]OAuth usage[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_cache]cache[/zrl][/td][td]OEmbed cache[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_channel]channel[/zrl][/td][td]local channels[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_chat]chat[/zrl][/td][td]chat room content[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_chatpresence]chatpresence[/zrl][/td][td]channel presence information for chat[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_chatroom]chatroom[/zrl][/td][td]data for the actual chat room[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_clients]clients[/zrl][/td][td]OAuth usage[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_config]config[/zrl][/td][td]main configuration storage[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_conv]conv[/zrl][/td][td]Diaspora private messages meta conversation structure[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_event]event[/zrl][/td][td]Events[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_fcontact]fcontact[/zrl][/td][td]friend suggestion stuff (obsolete)[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_ffinder]ffinder[/zrl][/td][td]friend suggestion stuff (obsolete)[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_fserver]fserver[/zrl][/td][td]obsolete[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_fsuggest]fsuggest[/zrl][/td][td]friend suggestion stuff (unused)[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_group_member]group_member[/zrl][/td][td]privacy groups (collections), group info[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_groups]groups[/zrl][/td][td]privacy groups (collections), member info[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_hook]hook[/zrl][/td][td]plugin hook registry[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_hubloc]hubloc[/zrl][/td][td]Red location storage, ties a hub location to an xchan[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_issue]issue[/zrl][/td][td]future bug/issue database[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_item]item[/zrl][/td][td]all posts and webpages[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_item_id]item_id[/zrl][/td][td]other identifiers on other services for posts[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_likes]likes[/zrl][/td][td]likes of 'things'[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_mail]mail[/zrl][/td][td]private messages[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_manage]manage[/zrl][/td][td]may be unused in Red, table of accounts that can "su" each other[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_menu]menu[/zrl][/td][td]webpage menu data[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_menu_item]menu_item[/zrl][/td][td]entries for webpage menus[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_notify]notify[/zrl][/td][td]notifications[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_obj]obj[/zrl][/td][td]object data for things (x has y)[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_outq]outq[/zrl][/td][td]Red output queue[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_pconfig]pconfig[/zrl][/td][td]personal (per channel) configuration storage[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_photo]photo[/zrl][/td][td]photo storage[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_poll]poll[/zrl][/td][td]data for polls[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_poll_elm]poll_elm[/zrl][/td][td]data for poll elements[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_profdef]profdef[/zrl][/td][td]custom profile field definitions[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_profext]profext[/zrl][/td][td]custom profile field data[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_profile]profile[/zrl][/td][td]channel profiles[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_profile_check]profile_check[/zrl][/td][td]DFRN remote auth use, may be obsolete[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_register]register[/zrl][/td][td]registrations requiring admin approval[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_session]session[/zrl][/td][td]web session storage[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_shares]shares[/zrl][/td][td]shared item information[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_sign]sign[/zrl][/td][td]Diaspora signatures. To be phased out.[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_site]site[/zrl][/td][td]site table to find directory peers[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_source]source[/zrl][/td][td]channel sources data[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_spam]spam[/zrl][/td][td]unfinished[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_sys_perms]sys_perms[/zrl][/td][td]extensible permissions for OAuth[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_term]term[/zrl][/td][td]item taxonomy (categories, tags, etc.) table[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_tokens]tokens[/zrl][/td][td]OAuth usage[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_updates]updates[/zrl][/td][td]directory sync updates[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_verify]verify[/zrl][/td][td]general purpose verification structure[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_vote]vote[/zrl][/td][td]vote data for polls[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_xchan]xchan[/zrl][/td][td]list of known channels in the universe[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_xchat]xchat[/zrl][/td][td]bookmarked chat rooms[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_xconfig]xconfig[/zrl][/td][td]as pconfig but for channels with no local account[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_xign]xign[/zrl][/td][td]channels ignored by friend suggestions[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_xlink]xlink[/zrl][/td][td]"friends of friends" linkages derived from poco, also ratings storage[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_xprof]xprof[/zrl][/td][td]if this hub is a directory server, contains basic public profile info of everybody in the network[/td][/tr]
+[tr][td][zrl=[baseurl]/help/database/db_xtag]xtag[/zrl][/td][td]if this hub is a directory server, contains tags or interests of everybody in the network[/td][/tr]
+[/table]
diff --git a/sources/doc/database/db_abook.bb b/sources/doc/database/db_abook.bb
new file mode 100644
index 00000000..a34e5199
--- /dev/null
+++ b/sources/doc/database/db_abook.bb
@@ -0,0 +1,55 @@
+[table]
+[tr][th]Field[/th][th]Description[/th][th]Type[/th][th]Null[/th][th]Key[/th][th]Default[/th][th]Extra
+[/th][/tr]
+[tr][td]abook_id[/td][td]Sequential ID[/td][td]int(10) unsigned[/td][td]NO[/td][td]PRI[/td][td]NULL[/td][td]auto_increment
+[/td][/tr]
+[tr][td]abook_account[/td][td]account.account_id of the channel which owns this record[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]abook_channel[/td][td]channel.channel_id of the channel which owns this record[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]abook_xchan[/td][td]xchan.xchan_hash of the target identity (this channel's connection)[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]abook_my_perms[/td][td]bitfield of all specific permissions granted this connection[/td][td]int(11)[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]abook_their_perms[/td][td]bitfield of all permissions granted to you by this connection[/td][td]int(11)[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]abook_closeness[/td][td]"closeness" value for optional affinity tool, 0-99[/td][td]tinyint(3) unsigned[/td][td]NO[/td][td]MUL[/td][td]99[/td][td]
+[/td][/tr]
+[tr][td]abook_rating[/td][td]The channel owner's (public) rating of this connection -10 to +10, default 0 or unrated[/td][td]int(11)[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]abook_rating_text[/td][td]The channel owner's (public) rating of this connection free form text[/td][td]text[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]abook_created[/td][td]Datetime this record was created[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]abook_updated[/td][td]Datetime this record was modified[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]abook_connected[/td][td]datetime of last successful "poll" for this connection[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]abook_dob[/td][td]Datetime of connection's birthday converted from *their* timezone to UTC[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]abook_flags[/td][td]Bitfield containing blocked(0x1), ignored(0x2), hidden(0x4), archived(0x8), pending(0x10), unconnected(0x20), self(0x80), feed(0x100)[/td][td]int(11)[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]abook_profile[/td][td]profile.guid of profile to display to this connection if authenticated[/td][td]char(64)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[/table]
+
+
+Notes:
+
+ABOOK_FLAGS_BLOCKED - Bi-directional communications with this channel are blocked, regardless of other permissions.
+
+ABOOK_FLAGS_IGNORED - Incoming communications from this channel are blocked, regardless of other permissions.
+
+ABOOK_FLAGS_HIDDEN - This connection will not be shown as a connection to anybody but the channel owner
+
+ABOOK_FLAGS_ARCHIVED - This connection is likely non-functioning and the entry and conversations are preserved, but further polled communications will not be attempted.
+
+ABOOK_FLAGS_PENDING - A connection request was received from this channel but has not been approved by the channel owner, public communications may still be visible but no additional permissions have been granted.
+
+ABOOK_FLAGS_UNCONNECTED - currently unused. Projected usage is to indicate "one-way" connections which were insitgated on this end but are still pending on the remote end.
+
+ABOOK_FLAGS_SELF is a special case where the owner is the target. Every channel has one abook entry with ABOOK_FLAGS_SELF with a target abook_xchan set to channel.channel_hash . When this flag is present, abook_my_perms is the default permissions granted to all new connections and several other fields are unused.
+
+ABOOK_FLAGS_FEED - indicates this connection is an RSS/Atom feed and may trigger special handling.
+
+Return to [zrl=[baseurl]/help/database]database documentation[/zrl]
\ No newline at end of file
diff --git a/sources/doc/database/db_account.bb b/sources/doc/database/db_account.bb
new file mode 100644
index 00000000..354f2d3a
--- /dev/null
+++ b/sources/doc/database/db_account.bb
@@ -0,0 +1,67 @@
+[table]
+[tr][th]Field[/th][th]Description[/th][th]Type[/th][th]Null[/th][th]Key[/th][th]Default[/th][th]Extra
+[/th][/tr]
+[tr][td]account_id[/td][td]table index[/td][td]int(10) unsigned[/td][td]NO[/td][td]PRI[/td][td]NULL[/td][td]auto_increment
+[/td][/tr]
+[tr][td]account_parent[/td][td]for hierarchical accounts, the account_id of the parent to this one, if account_parent = account_id, this is the top level account[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]account_default_channel[/td][td]channel_id of channel to connect on login[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]account_salt[/td][td]complexity token for account_password[/td][td]char(32)[/td][td]NO[/td][td][/td][td][/td][td]
+[/td][/tr]
+[tr][td]account_password[/td][td]hashed password for this account[/td][td]char(255)[/td][td]NO[/td][td][/td][td][/td][td]
+[/td][/tr]
+[tr][td]account_email[/td][td]essentially the login ID, although it is usually possible to login with a channel address[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]account_external[/td][td]Currently unused[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]account_language[/td][td]default language (closest available browser-accept language when account was created)[/td][td]char(16)[/td][td]NO[/td][td][/td][td]en[/td][td]
+[/td][/tr]
+[tr][td]account_created[/td][td]timestamp of account creation[/td][td]datetime[/td][td]NO[/td][td][/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]account_lastlog[/td][td]timestamp of last login (or daily update if "remember me" is in effect)[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]account_flags[/td][td]see notes[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]account_roles[/td][td]see notes[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]account_reset[/td][td]verification token for password reset[/td][td]char(255)[/td][td]NO[/td][td][/td][td][/td][td]
+[/td][/tr]
+[tr][td]account_expires[/td][td]timestamp when account expires and will be deleted[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]account_expire_notified[/td][td]timestamp of last warning of account expiration[/td][td]datetime[/td][td]NO[/td][td][/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]account_service_class[/td][td]service class for this account, determines what if any limits/restrictions are in place[/td][td]char(32)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]account_level[/td][td]future use[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]account_password_changed[/td][td]timestamp of last password change - to limit account deletion for 48 hours to prevent malicious activity[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[/table]
+
+Notes:
+
+
+
+/**
+ * Account Flags
+ */
+
+define ( 'ACCOUNT_OK', 0x0000 );
+define ( 'ACCOUNT_UNVERIFIED', 0x0001 );
+define ( 'ACCOUNT_BLOCKED', 0x0002 );
+define ( 'ACCOUNT_EXPIRED', 0x0004 );
+define ( 'ACCOUNT_REMOVED', 0x0008 );
+define ( 'ACCOUNT_PENDING', 0x0010 );
+
+/**
+ * Account roles
+ */
+
+define ( 'ACCOUNT_ROLE_ALLOWCODE', 0x0001 ); // 1 - this account can create content with PHP/Javascript
+define ( 'ACCOUNT_ROLE_SYSTEM', 0x0002 ); // 2 - this is the special system account
+define ( 'ACCOUNT_ROLE_DEVELOPER', 0x0004 );
+define ( 'ACCOUNT_ROLE_ADMIN', 0x1000 ); // 4096 - this account is an administrator
+
+
+Return to [zrl=[baseurl]/help/database]database documentation[/zrl]
\ No newline at end of file
diff --git a/sources/doc/database/db_addon.bb b/sources/doc/database/db_addon.bb
new file mode 100644
index 00000000..afa06d56
--- /dev/null
+++ b/sources/doc/database/db_addon.bb
@@ -0,0 +1,24 @@
+[table]
+[tr][th]Field[/th][th]Description[/th][th]Type[/th][th]Null[/th][th]Key[/th][th]Default[/th][th]Extra
+[/th][/tr]
+[tr][td]id[/td][td][/td]generated index[td]int(11)[/td][td]NO[/td][td]PRI[/td][td]NULL[/td][td]auto_increment
+[/td][/tr]
+[tr][td]name[/td][td]plugin base (file)name[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]version[/td][td]currently unused[/td][td]char(255)[/td][td]NO[/td][td][/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]installed[/td][td]currently always 1[/td][td]tinyint(1)[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]hidden[/td][td]currently unused[/td][td]tinyint(1)[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]timestamp[/td][td]file timestamp to check for reloads[/td][td]bigint(20)[/td][td]NO[/td][td][/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]plugin_admin[/td][td]1 = has admin config, 0 = has no admin config[/td][td]tinyint(1)[/td][td]NO[/td][td][/td][td]0[/td][td]
+[/td][/tr]
+[/table]
+
+Notes:
+
+These are addons which have been enabled by the site administrator on the admin/plugin page
+
+Return to [zrl=[baseurl]/help/database]database documentation[/zrl]
\ No newline at end of file
diff --git a/sources/doc/database/db_app.bb b/sources/doc/database/db_app.bb
new file mode 100644
index 00000000..7076bffd
--- /dev/null
+++ b/sources/doc/database/db_app.bb
@@ -0,0 +1,36 @@
+[table]
+[tr][th]Field[/th][th]Description[/th][th]Type[/th][th]Null[/th][th]Key[/th][th]Default[/th][th]Extra
+[/th][/tr]
+[tr][td]id[/td][td]generated index[/td][td]int(11)[/td][td]NO[/td][td]PRI[/td][td]NULL[/td][td]auto_increment
+[/td][/tr]
+[tr][td]app_id[/td][td]hash identifying this app[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_sig[/td][td]currently unused[/td][td]char(255)[/td][td]NO[/td][td][/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_author[/td][td]xchan_hash of app creator[/td][td]char(255)[/td][td]NO[/td][td][/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_name[/td][td]name of app[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_desc[/td][td]optional description of app[/td][td]text[/td][td]NO[/td][td][/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]app_url[/td][td]target_url[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_photo[/td][td]app icon[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_version[/td][td]version of app[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_channel[/td][td]channel_id owning this instance of the app[/td][td]int(11)[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]app_addr[/td][td]reddress/webbie of app creator[/td][td]char(255)[/td][td]NO[/td][td][/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_price[/td][td]free-form price field[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_page[/td][td]currently unused[/td][td]char(255)[/td][td]NO[/td][td][/td][td][/td][td]
+[/td][/tr]
+[tr][td]app_requires[/td][td]currently unused[/td][td]char(255)[/td][td]NO[/td][td][/td][td][/td][td]
+[/td][/tr]
+[/table]
+
+Storage for personal apps
+
+Return to [zrl=[baseurl]/help/database]database documentation[/zrl]
\ No newline at end of file
diff --git a/sources/doc/database/db_attach.bb b/sources/doc/database/db_attach.bb
new file mode 100644
index 00000000..4514c87f
--- /dev/null
+++ b/sources/doc/database/db_attach.bb
@@ -0,0 +1,50 @@
+[table]
+[tr][th]Field[/th][th]Description[/th][th]Type[/th][th]Null[/th][th]Key[/th][th]Default[/th][th]Extra
+[/th][/tr]
+[tr][td]id[/td][td]generated index[/td][td]int(10) unsigned[/td][td]NO[/td][td]PRI[/td][td]NULL[/td][td]auto_increment
+[/td][/tr]
+[tr][td]aid[/td][td]account_id of owner[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]uid[/td][td]channel_id of owner[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]hash[/td][td]hash for cross-site identification[/td][td]char(64)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]creator[/td][td]xchan_hash of author/creator[/td][td]char(128)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]filename[/td][td]filename of original[/td][td]char(255)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]filetype[/td][td]mimetype[/td][td]char(64)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]filesize[/td][td]size in bytes[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]revision[/td][td]for version control (partially implemented)[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]folder[/td][td]attach.hash of parent folder[/td][td]char(64)[/td][td]NO[/td][td]MUL[/td][td][/td][td]
+[/td][/tr]
+[tr][td]flags[/td][td]see notes[/td][td]int(10) unsigned[/td][td]NO[/td][td]MUL[/td][td]0[/td][td]
+[/td][/tr]
+[tr][td]data[/td][td]file data or pathname to stored data if ATTACH_FLAG_OS[/td][td]longblob[/td][td]NO[/td][td][/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]created[/td][td]creation time[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]edited[/td][td]last edit time[/td][td]datetime[/td][td]NO[/td][td]MUL[/td][td]0000-00-00 00:00:00[/td][td]
+[/td][/tr]
+[tr][td]allow_cid[/td][td]permissions[/td][td]mediumtext[/td][td]NO[/td][td][/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]allow_gid[/td][td]permissions[/td][td]mediumtext[/td][td]NO[/td][td][/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]deny_cid[/td][td]permissions[/td][td]mediumtext[/td][td]NO[/td][td][/td][td]NULL[/td][td]
+[/td][/tr]
+[tr][td]deny_gid[/td][td]permissions[/td][td]mediumtext[/td][td]NO[/td][td][/td][td]NULL[/td][td]
+[/td][/tr]
+[/table]
+
+
+Bitmasks
+
+define ( 'ATTACH_FLAG_DIR', 0x0001); This is a directory
+define ( 'ATTACH_FLAG_OS', 0x0002); Data content is link to OS file containing data, if unset the data filed contains the file data
+
+permissions are xchan_hash or group_hash surrounded by angle chars. e.g. '
+
+
+
+
+
+
+
+
+Hubzilla\Import\Import Class Reference
+
+
+
+
+
The documentation for this class was generated from the following file:
++Public Member Functions | |
| get_credentials () | |
| get_itemlist () | |
| get_item_ident ($item) | |
| get_item ($item_ident) | |
| get_taxonomy ($item_ident) | |
| get_children ($item_ident) | |
| convert_item ($item_ident) | |
| convert_taxonomy ($item_ident) | |
| convert_child ($child) | |
| store ($item, $update=false) | |
| run () | |
+Protected Attributes | |
| $itemlist = null | |
| $src_items = null | |
| $items = null | |
+Private Attributes | |
| $credentials = null | |
Member Function Documentation
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::convert_child | +( | ++ | $child | ) | ++ |
+
+
+Referenced by Hubzilla\Import\Import\run().
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::convert_item | +( | ++ | $item_ident | ) | ++ |
+
+
+Referenced by Hubzilla\Import\Import\run().
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::convert_taxonomy | +( | ++ | $item_ident | ) | ++ |
+
+
+Referenced by Hubzilla\Import\Import\run().
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::get_children | +( | ++ | $item_ident | ) | ++ |
+
+
+Referenced by Hubzilla\Import\Import\run().
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::get_credentials | +( | +) | ++ |
+
+
+Referenced by Hubzilla\Import\Import\run().
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::get_item | +( | ++ | $item_ident | ) | ++ |
+
+
+Referenced by Hubzilla\Import\Import\run().
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::get_item_ident | +( | ++ | $item | ) | ++ |
+
+
+
+
+
+
+
+
+
| Hubzilla\Import\Import::get_itemlist | +( | +) | ++ |
+
+
+Referenced by Hubzilla\Import\Import\run().
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::get_taxonomy | +( | ++ | $item_ident | ) | ++ |
+
+
+Referenced by Hubzilla\Import\Import\run().
+ +
+
+
+
+
+
+
| Hubzilla\Import\Import::run | +( | +) | ++ |
+
+
+
+
+
+
+
+
| Hubzilla\Import\Import::store | +( | ++ | $item, | +
| + | + | + | $update = false |
+
| + | ) | ++ |
+
+
+Member Data Documentation
+ +
+
+
+
+
+
+
+
|
+ +private | +
+
+
+Referenced by Hubzilla\Import\Import\get_credentials().
+ +
+
+
+
+
+
+
+
|
+ +protected | +
+
+
+Referenced by Hubzilla\Import\Import\get_itemlist().
+ +
+
+
+
+
+
+
+
|
+ +protected | +
+
+
+
+
+
+
+
+
+
|
+ +protected | +
+
+
+The documentation for this class was generated from the following file:
-
+
- include/Import/Importer.php +
Hubzilla Doxygen API Documentation not rendered
+======= +$Projectname Doxygen API Documentation not rendered
+>>>>>>> f866a42a42b9e12756353f5bb39a0f31a64bb26a +To get the Doxygen API Documentation you must render it with the program Doxygen (included in most distributions). ++$ doxygen util/Doxyfile ++
+back + + diff --git a/sources/doc/install.bb b/sources/doc/install.bb new file mode 100644 index 00000000..e68b4a23 --- /dev/null +++ b/sources/doc/install.bb @@ -0,0 +1,4 @@ +#include install/INSTALL.txt; + +#include doc/macros/main_footer.bb; + diff --git a/sources/doc/install/sample-lighttpd.conf b/sources/doc/install/sample-lighttpd.conf new file mode 100644 index 00000000..db26c3b6 --- /dev/null +++ b/sources/doc/install/sample-lighttpd.conf @@ -0,0 +1,90 @@ +# See http://redmine.lighttpd.net/projects/lighttpd/wiki/Docs:ConfigurationOptions + +### LOAD MODULES +server.modules = ( + "mod_access", + "mod_accesslog", + "mod_fastcgi", + "mod_redirect", + "mod_rewrite" +) + +### BASIC STUFF +server.port = 80 + +server.username = "http" + +server.groupname = "http" + +server.document-root = "/path/to/your/www/files" #adjust to your setup + +server.errorlog = "/var/log/lighttpd/error.log" + +accesslog.filename = "/var/log/lighttpd/access.log" + +### DISABLE DIR LISTING +dir-listing.activate = "disable" + +### DISABLE REJECT EXPECT HEADER +### (needed for curl POST requests - otherwise they fail with error 417) +server.reject-expect-100-with-417 = "disable" + +### DEFINE SUPPORTED INDEX FILENAMES +index-file.names = ( + "index.html", + "index.htm", + "index.php" +) + +### DEFINE SUPPORTED MIME TYPES +mimetype.assign = ( + ".html" => "text/html", + ".htm" => "text/html", + ".css" => "text/css", + ".txt" => "text/plain", + ".svg" => "image/svg+xml", + ".jpg" => "image/jpeg", + ".png" => "image/png" +) + +### DONT EVER SERVE FILES WITH EXTENSION +static-file.exclude-extensions = ( ".php" ) + +### PHP WITH PHP-FPM +### (needs php-fpm installed and running) +fastcgi.server = ( + ".php" => ( + "localhost" => ( + "socket" => "/run/php-fpm/php-fpm.sock", + "broken-scriptfilename" => "enable", + "allow-x-sendfile" => "enable" + ) + ) +) + +### ENABLE SSL +$SERVER["socket"] == ":443" { + ssl.engine = "enable" + ssl.ca-file = "/etc/lighttpd/certs/ca-certs.crt" #adjust to your needs + ssl.pemfile = "/etc/lighttpd/certs/red-ssl.crt" #adjust to your needs + + ssl.use-compression = "disable" + ssl.use-sslv2 = "disable" + ssl.use-sslv3 = "disable" + ssl.cipher-list = "ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA" +} + +### RISTRICT ACCESS TO DIRECTORYS AND FILES +$HTTP["url"] =~ "\.(out|log|htaccess)$" { + url.access-deny = ("") +} + +$HTTP["url"] =~ "(^|/)\.git|(^|/)store" { + url.access-deny = ("") +} + +### URL REWRITE RULES +url.rewrite-if-not-file = ( + "^\/([^\?]*)\?(.*)$" => "/index.php?q=$1&$2", + "^\/(.*)$" => "/index.php?q=$1" +) diff --git a/sources/doc/install/sample-nginx.conf b/sources/doc/install/sample-nginx.conf new file mode 100644 index 00000000..e9a80d22 --- /dev/null +++ b/sources/doc/install/sample-nginx.conf @@ -0,0 +1,142 @@ +## +# Red Nginx configuration +# by Olaf Conradi +# +# On Debian based distributions you can add this file to +# /etc/nginx/sites-available +# +# Then customize to your needs. To enable the configuration +# symlink it to /etc/nginx/sites-enabled and reload Nginx using +# +# service nginx reload +## + +## +# You should look at the following URL's in order to grasp a solid understanding +# of Nginx configuration files in order to fully unleash the power of Nginx. +# +# http://wiki.nginx.org/Pitfalls +# http://wiki.nginx.org/QuickStart +# http://wiki.nginx.org/Configuration +## + +## +# This configuration assumes your domain is example.net +# You have a separate subdomain red.example.net +# You want all red traffic to be https +# You have an SSL certificate and key for your subdomain +# You have PHP FastCGI Process Manager (php5-fpm) running on localhost +# You have Red installed in /var/www/red +## + +server { + listen 80; + server_name red.example.net; + + index index.php; + root /var/www/red; + rewrite ^ https://red.example.net$request_uri? permanent; +} + +## +# Configure Red with SSL +# +# All requests are routed to the front controller +# except for certain known file types like images, css, etc. +# Those are served statically whenever possible with a +# fall back to the front controller (needed for avatars, for example) +## + +server { + listen 443 ssl; + server_name red.example.net; + + ssl on; + ssl_certificate /etc/nginx/ssl/red.example.net.chain.pem; + ssl_certificate_key /etc/nginx/ssl/example.net.key; + ssl_session_timeout 5m; + ssl_protocols TLSv1 TLSv1.1 TLSv1.2; + ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-DSS-AES128-SHA256:DHE-DSS-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA:!DHE-RSA-AES128-GCM-SHA256:!DHE-RSA-AES256-GCM-SHA384:!DHE-RSA-AES128-SHA256:!DHE-RSA-AES256-SHA:!DHE-RSA-AES128-SHA:!DHE-RSA-AES256-SHA256:!DHE-RSA-CAMELLIA128-SHA:!DHE-RSA-CAMELLIA256-SHA; + ssl_prefer_server_ciphers on; + + fastcgi_param HTTPS on; + + index index.php; + charset utf-8; + root /var/www/red; + access_log /var/log/nginx/red.log; + #Uncomment the following line to include a standard configuration file + #Note that the most specific rule wins and your standard configuration + #will therefore *add* to this file, but not override it. + #include standard.conf + # allow uploads up to 20MB in size + client_max_body_size 20m; + client_body_buffer_size 128k; + + # rewrite to front controller as default rule + location / { + if ($is_args != "") { + rewrite ^/(.*) /index.php?q=$uri&$args last; + } + rewrite ^/(.*) /index.php?q=$uri last; + } + + # make sure webfinger and other well known services aren't blocked + # by denying dot files and rewrite request to the front controller + location ^~ /.well-known/ { + allow all; + rewrite ^/(.*) /index.php?q=$uri&$args last; + } + + # statically serve these file types when possible + # otherwise fall back to front controller + # allow browser to cache them + # added .htm for advanced source code editor library + location ~* \.(jpg|jpeg|gif|png|ico|css|js|htm|html|ttf|woff|svg)$ { + expires 30d; + try_files $uri /index.php?q=$uri&$args; + } + + # block these file types + location ~* \.(tpl|md|tgz|log|out)$ { + deny all; + } + + # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000 + # or a unix socket + location ~* \.php$ { + # Zero-day exploit defense. + # http://forum.nginx.org/read.php?2,88845,page=3 + # Won't work properly (404 error) if the file is not stored on this + # server, which is entirely possible with php-fpm/php-fcgi. + # Comment the 'try_files' line out if you set up php-fpm/php-fcgi on + # another machine. And then cross your fingers that you won't get hacked. + try_files $uri =404; + + # NOTE: You should have "cgi.fix_pathinfo = 0;" in php.ini + fastcgi_split_path_info ^(.+\.php)(/.+)$; + + # With php5-cgi alone: + # fastcgi_pass 127.0.0.1:9000; + + # With php5-fpm: + fastcgi_pass unix:/var/run/php5-fpm.sock; + + include fastcgi_params; + fastcgi_index index.php; + fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; + } + + # deny access to all dot files + location ~ /\. { + deny all; + } + +#deny access to store + + location ~ /store { + deny all; + } + + +} diff --git a/sources/doc/intro_for_developers.bb b/sources/doc/intro_for_developers.bb new file mode 100644 index 00000000..b8a4e4eb --- /dev/null +++ b/sources/doc/intro_for_developers.bb @@ -0,0 +1,114 @@ +[b]Red Developer Guide[/b] + +[b]File system layout:[/b] + +[addon] optional addons/plugins + +[boot.php] Every process uses this to bootstrap the application structure + +[doc] Help Files + +[images] core required images + +[include] The "model" in MVC - (back-end functions), also contains PHP "executables" for background processing + +[index.php] The front-end controller for web access + +[install] Installation and upgrade files and DB schema + +[library] Third party modules (must be license compatible) + +[mod] Controller modules based on URL pathname (e.g. #^[url=http://sitename/foo]http://sitename/foo[/url] loads mod/foo.php) + +[mod/site/] site-specific mod overrides, excluded from git + +[util] translation tools, main English string database and other miscellaneous utilities + +[version.inc] contains current version (auto-updated via cron for the master repository and distributed via git) + +[view] theming and language files + +[view/(css,js,img,php,tpl)] default theme files + +[view/(en,it,es ...)] language strings and resources + +[view/theme/] individual named themes containing (css,js,img,php,tpl) over-rides + +[b]The Database:[/b] + + [li]abook - contact table, replaces Friendica 'contact'[/li] + [li]account - service provider account[/li] + [li]addon - registered plugins[/li] + [li]app - peronal app data[/li] + [li]attach - file attachments[/li] + [li]auth_codes - OAuth usage[/li] + [li]cache - OEmbed cache[/li] + [li]channel - replaces Friendica 'user'[/li] + [li]chat - chat room content[/li] + [li]chatpresence - channel presence information for chat[/li] + [li]chatroom - data for the actual chat room[/li] + [li]clients - OAuth usage[/li] + [li]config - main configuration storage[/li] + [li]conv - Diaspora private messages[/li] + [li]event - Events[/li] + [li]fcontact - friend suggestion stuff[/li] + [li]ffinder - friend suggestion stuff[/li] + [li]fserver - obsolete[/li] + [li]fsuggest - friend suggestion stuff[/li] + [li]groups - privacy groups[/li] + [li]group_member - privacy groups[/li] + [li]hook - plugin hook registry[/li] + [li]hubloc - Red location storage, ties a location to an xchan[/li] + [li]item - posts[/li] + [li]item_id - other identifiers on other services for posts[/li] + [li]likes - likes of 'things'[/li] + [li]mail - private messages[/li] + [li]manage - may be unused in Red, table of accounts that can "su" each other[/li] + [li]menu - channel menu data[/li] + [li]menu_item - items uses by channel menus[/li] + [li]notify - notifications[/li] + [li]notify-threads - need to factor this out and use item thread info on notifications[/li] + [li]obj - object data for things (x has y)[/li] + [li]outq - Red output queue[/li] + [li]pconfig - personal (per channel) configuration storage[/li] + [li]photo - photo storage[/li] + [li]poll - data for polls[/li] + [li]poll_elm - data for poll elements[/li] + [li]profdef - custom profile field definitions[/li] + [li]profext - custom profile field data[/li] + [li]profile - channel profiles[/li] + [li]profile_check - DFRN remote auth use, may be obsolete[/li] + [li]register - registrations requiring admin approval[/li] + [li]session - web session storage[/li] + [li]shares - shared item information[/li] + [li[sign - Diaspora signatures. To be phased out.[/li] + [li]site - site table to find directory peers[/li] + [li]source - channel sources data[/li] + [li]spam - unfinished[/li] + [li]sys_perms - extensible permissions for the sys channel[/li] + [li]term - item taxonomy (categories, tags, etc.) table[/li] + [li]tokens - OAuth usage[/li] + [li]updates - directory sync updates[/li] + [li]verify - general purpose verification structure[/li] + [li]vote - vote data for polls[/li] + [li]xchan - replaces 'gcontact', list of known channels in the universe[/li] + [li]xchat - bookmarked chat rooms[/li] + [li]xconfig - as pconfig but for channels with no local account[/li] + [li]xlink - "friends of friends" linkages derived from poco[/li] + [li]xprof - if this hub is a directory server, contains basic public profile info of everybody in the network[/li] + [li]xtag - if this hub is a directory server, contains tags or interests of everybody in the network[/li] + + +[b]How to theme Red - by Olivier Migeot[/b] + +This is a short documentation on what I found while trying to modify Red's appearance. + +First, you'll need to create a new theme. This is in /view/theme, and I chose to copy 'redbasic' since it's the only available for now. Let's assume I named it . + +Oh, and don't forget to rename the _init function in /php/theme.php to be _init() instead of redbasic_init(). + +At that point, if you need to add javascript or css files, add them to /js or /css, and then "register" them in _init() through head_add_js('file.js') and head_add_css('file.css'). + +Now you'll probably want to alter a template. These can be found in in /view/tpl OR view//tpl. All you should have to do is copy whatever you want to tweak from the first place to your theme's own tpl directory. + +#include doc/macros/main_footer.bb; diff --git a/sources/doc/macros/addons_footer.bb b/sources/doc/macros/addons_footer.bb new file mode 100644 index 00000000..32814c59 --- /dev/null +++ b/sources/doc/macros/addons_footer.bb @@ -0,0 +1,2 @@ +Return to the [zrl=[baseurl]/help/addons]Addons documentation[/zrl] +Return to the [zrl=[baseurl]/help/main]Main documentation[/zrl] diff --git a/sources/doc/macros/cloud_footer.bb b/sources/doc/macros/cloud_footer.bb new file mode 100644 index 00000000..798cc9ea --- /dev/null +++ b/sources/doc/macros/cloud_footer.bb @@ -0,0 +1,2 @@ +Return to the [zrl=[baseurl]/help/cloud]Cloud documentation[/zrl] +Return to the [zrl=[baseurl]/help/main]Main documentation page[/zrl] diff --git a/sources/doc/macros/de/addons_footer.bb b/sources/doc/macros/de/addons_footer.bb new file mode 100644 index 00000000..068bb7ec --- /dev/null +++ b/sources/doc/macros/de/addons_footer.bb @@ -0,0 +1,2 @@ +Zurück zur [zrl=[baseurl]/help/addons]Addons-Hilfe[/zrl] +Zurück zur [zrl=[baseurl]/help/main]Hilfe-Startseite[/zrl] diff --git a/sources/doc/macros/de/cloud_footer.bb b/sources/doc/macros/de/cloud_footer.bb new file mode 100644 index 00000000..921448a3 --- /dev/null +++ b/sources/doc/macros/de/cloud_footer.bb @@ -0,0 +1,2 @@ +Zurück zur [zrl=[baseurl]/help/cloud]Cloud-Hilfe[/zrl] +Zurück zur [zrl=[baseurl]/help/main]Hilfe-Startseite[/zrl] diff --git a/sources/doc/macros/de/main_footer.bb b/sources/doc/macros/de/main_footer.bb new file mode 100644 index 00000000..e7160362 --- /dev/null +++ b/sources/doc/macros/de/main_footer.bb @@ -0,0 +1 @@ +Zurück zur [zrl=[baseurl]/help/main]Hilfe-Startseite[/zrl] diff --git a/sources/doc/macros/de/troubleshooting_footer.bb b/sources/doc/macros/de/troubleshooting_footer.bb new file mode 100644 index 00000000..be8c13a2 --- /dev/null +++ b/sources/doc/macros/de/troubleshooting_footer.bb @@ -0,0 +1,2 @@ +Zurück zur [zrl=[baseurl]/help/troubleshooting]Troubleshooting-Startseite[/zrl] +Zurück zur [zrl=[baseurl]/help/troubleshooting]Hilfe-Startseite[/zrl] diff --git a/sources/doc/macros/main_footer.bb b/sources/doc/macros/main_footer.bb new file mode 100644 index 00000000..08f671de --- /dev/null +++ b/sources/doc/macros/main_footer.bb @@ -0,0 +1 @@ +Return to the [zrl=[baseurl]/help/main]Main documentation page[/zrl] diff --git a/sources/doc/macros/troubleshooting_footer.bb b/sources/doc/macros/troubleshooting_footer.bb new file mode 100644 index 00000000..c7603a62 --- /dev/null +++ b/sources/doc/macros/troubleshooting_footer.bb @@ -0,0 +1,2 @@ +[zrl=[baseurl]/help/troubleshooting]Troubleshooting documentation[/zrl] +[zrl=[baseurl]/help/troubleshooting]Documentation Main Page[/zrl] diff --git a/sources/doc/main.bb b/sources/doc/main.bb new file mode 100644 index 00000000..6998ee90 --- /dev/null +++ b/sources/doc/main.bb @@ -0,0 +1,86 @@ + +[zrl=[baseurl]/help/about][b]What is $Projectname?[/b][/zrl] +$Projectname is a decentralized communication and publishing platform that enables you to keep in control of your communication needs by automatic encryption and finely grained access control. It's you, and only you who decides who is allowed to see your stuff. + +[zrl=[baseurl]/help/features][b]$Projectname Features[/b][/zrl] + +$Projectname is already running as a global distributed network and proves its versatility and scalability from standalone to huge sites on a daily basis. +Think of standalone family communication platforms, distributed online communities, support forums, blogs and homepages. Or professional content providers with commercial premium channels and targeted content acces. Whatever you want, the $Projectname is there to cater to your creativity. + +[zrl=[baseurl]/help/what_is_zot][b]Got Zot? Well, you should.[/b][/zrl] +Zot is the great new communicaton protocol invented especially for $Projectname. As a member you are no longer bound to a single site or hub thanks to "Nomadic Identities". Migrate easily to another server and keep your contacts intact, or clone it and run the same channel on several servers. Just in case one of them might shut down, you don't lose out. Plus once you are inside $Projectname there is no need for you to authenticate twice, even when accessing another $Projectname site. Zot is what sets $Projectname apart. + +[h3]Getting Started[/h3] +[zrl=[baseurl]/help/Privacy]Privacy Policy[/zrl] +[zrl=[baseurl]/help/registration]Account Registration[/zrl] +[zrl=[baseurl]/help/accounts_profiles_channels_basics]You at the $Projectname: accounts, profiles and channels in short[/zrl] +[zrl=[baseurl]/help/profiles]Profiles[/zrl] +[zrl=[baseurl]/help/channels]Channels[/zrl] +[zrl=[baseurl]/help/roles]Permission roles and Channel types[/zrl] +[zrl=[baseurl]/help/first-post]Your first posting[/zrl] +[zrl=[baseurl]/help/connecting_to_channels]Connecting To Other Channels[/zrl] +[zrl=[baseurl]/help/permissions]Permissions And Encryption: You Are In Control[/zrl] +[zrl=[baseurl]/help/cloud]Cloud Storage[/zrl] +[zrl=[baseurl]/help/remove_account]Remove Channel or Account[/zrl] + +[h3]Members Help[/h3] +[zrl=[baseurl]/help/tags_and_mentions]Tags and Mentions[/zrl] +[zrl=[baseurl]/help/webpages]Web Pages[/zrl] +[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] +[zrl=[baseurl]/help/addons]Help With Addons[/zrl] +[zrl=[baseurl]/help/diaspora_compat]Diaspora Communications Compatibility (Diaspora and Friendica)[/zrl] +[zrl=[baseurl]/help/faq_members]FAQ For Members[/zrl] + +[h3]Administrators Help[/h3] +[zrl=[baseurl]/help/install]Install[/zrl] +[zrl=[baseurl]/help/red2pi]Installing Red on the Raspberry Pi[/zrl] +[zrl=[baseurl]/help/troubleshooting]Troubleshooting Tips[/zrl] +[zrl=[baseurl]/help/hidden_configs]Tweaking $Projectname's Hidden Configurations[/zrl] +[zrl=[baseurl]/help/faq_admins]FAQ For Admins[/zrl] +[zrl=[baseurl]/help/service_classes]Service Classes[/zrl] + +[h3]Technical Documentation[/h3] +[zrl=[baseurl]/help/history]$Projectname history[/zrl] +[zrl=[baseurl]/help/Zot---A-High-Level-Overview]A high level overview of Zot[/zrl] +[zrl=[baseurl]/help/zot]An introduction to Zot[/zrl] +[zrl=[baseurl]/help/zot_structures]Zot Stuctures[/zrl] +[zrl=[baseurl]/help/comanche]Comanche Page Descriptions[/zrl] +[zrl=[baseurl]/help/Creating-Templates]Creating Comanche Templates[/zrl] +[zrl=[baseurl]/help/Widgets]Widgets[/zrl] +[zrl=[baseurl]/help/plugins]Plugins[/zrl] +[zrl=[baseurl]/help/doco]Contributing Documentation[/zrl] +[zrl=[baseurl]/help/DerivedTheme1]Creating Derivative Themes[/zrl] +[zrl=[baseurl]/help/schema_development]Schemas[/zrl] +[zrl=[baseurl]/help/Translations]Translations[/zrl] +[zrl=[baseurl]/help/developers]Developers[/zrl] +[zrl=[baseurl]/help/intro_for_developers]Intro for Developers[/zrl] +[zrl=[baseurl]/help/database]Database schema documantation[/zrl] +[zrl=[baseurl]/help/api_functions]API functions[/zrl] +[zrl=[baseurl]/help/api_posting]Posting to the red# using the API[/zrl] +[zrl=[baseurl]/help/developer_function_primer]Red Functions 101[/zrl] +[zrl=[baseurl]/doc/html/]Code Reference (Doxygen generated - sets cookies)[/zrl] +[zrl=[baseurl]/help/to_do_doco]To-Do list for the Red Documentation Project[/zrl] +[zrl=[baseurl]/help/to_do_code]To-Do list for Developers[/zrl] +[zrl=[baseurl]/help/roadmap]Version 3 roadmap[/zrl] +[zrl=[baseurl]/help/git_for_non_developers]Git for Non-Developers[/zrl] +[zrl=[baseurl]/help/dev_beginner]Step-for-step manual for beginning developers[/zrl] + +[h3]Frequently Asked Questions For Developers[/h3] +[zrl=[baseurl]/help/faq_developers]FAQ For Developers[/zrl] + +[h3]External Resources[/h3] +[zrl=[baseurl]/help/external-resource-links]External Resource Links[/zrl] +[url=https://github.com/redmatrix/hubzilla]Main Website[/url] +[url=https://github.com/redmatrix/hubzilla-addons]Addon Website[/url] +[url=https://zothub.com/channel/one]Development Channel[/url] +[url=https://federated.social/channel/postgres]Postgres-specific $Projectname Admin Support Channel[/url] + +[url=[baseurl]/help/credits]$Projectname Credits[/url] + +[h3]About This $Projectname Hub[/h3] +[zrl=[baseurl]/help/TermsOfService]Terms of Service For This Hub[/zrl] +[zrl=[baseurl]/siteinfo]Hub Information (/siteinfo)[/zrl] +[zrl=[baseurl]/siteinfo/json]Detailed Technical Hub Information in JSON format(/siteinfo/json)[/zrl] diff --git a/sources/doc/nb-no/api_functions.md b/sources/doc/nb-no/api_functions.md new file mode 100644 index 00000000..f385dee0 --- /dev/null +++ b/sources/doc/nb-no/api_functions.md @@ -0,0 +1,138 @@ +Red Twitter API +=============== + +Det "grunnleggende" Red web API-et er basert på Twitter API-et, siden dette gir umiddelbar samhandling med et stort antall tredjepartsklienter og programmer uten å kreve noen kodeendring hos disse. Det er også et super-set av StatusNet-versjonen av Twitter API-et, siden den også har bred eksisterende støtte. + +Red har flere muligheter som ikke vises gjennom Twitter-grensesnittene, der vi tvinges til å gjøre API-funksjoner "dummere" for å kunne arbeide med den primitive kommunikasjons- og personvernmodellen i Twitter/StatusNet. Vi planlegger å utvide Twitter-API-et slik at Red-spesifikke klienter kan ta i bruk alle funksjoner i Red uten begrensninger. + +Et dedikert Red API som samvirker med egne datastrukturer og tillatelser er under utvikling, og dette krever ikke oversettelse til andre personvern- og tillatelsesmodeller og lagringsformater. Denne vil bli beskrevet i andre dokumenter. Prefikset for alle egne endepunkter er 'api/red'. + +Red tilbyr tilgang til flere kanaler via samme innloggingskonto. Med Red vil enhver API-funksjon som krever autentisering akseptere et parameter - &channel={channel_nickname} - og vil velge den kanalen og gjøre den gjeldende før utføring av API-kommandoen. Som standard er det standardkanalen i kontoen som velges. + +Red tilbyr også en utvidet tillatelsesmodell. Grunnet fraværet av Red-spesifikke API kall til å angi tillatelser, så vil disse innstillingene bli satt til standardtillatelsene assosiert med den gjeldende kanalen. + +Red vil antakelig aldri helt kunne støtte Twitter sine 'api/friendships' funksjoner, fordi Red er ikke et sosialt nettverk og har ikke innebygget noe konsept om "vennskap" - den gjenkjenner tillatelser til å gjøre ting (eller ikke gjøre ting hvis det er det som trengs). + +Tegnforklaring: T= Twitter, S= StatusNet, F= Friendica, R= Red, ()=Virker ikke ennå, J= kun JSON (XML-formater er avlegs) + + + +Twitter API kompatible funksjoner: + +* api/account/verify_credentials T,S,F,R +* api/statuses/update T,S,F,R +* api/users/show T,S,F,R +* api/statuses/home_timeline T,S,F,R +* api/statuses/friends_timeline T,S,F,R +* api/statuses/public_timeline T,S,F,R +* api/statuses/show T,S,F,R +* api/statuses/retweet T,S,F,R +* api/statuses/destroy T,S,F,(R) +* api/statuses/mentions T,S,F,(R) +* api/statuses/replies T,S,F,(R) +* api/statuses/user_timeline T,S,F,(R) +* api/favorites T,S,F,(R) +* api/account/rate_limit_status T,S,F,R +* api/help/test T,S,F,R +* api/statuses/friends T,S,F,R +* api/statuses/followers T,S,F,R +* api/friends/ids T,S,F,R +* api/followers/ids T,S,F,R +* api/direct_messages/new T,S,F,(R) +* api/direct_messages/conversation T,S,F,(R) +* api/direct_messages/all T,S,F,(R) +* api/direct_messages/sent T,S,F,(R) +* api/direct_messages T,S,F,(R) +* api/oauth/request_token T,S,F,R +* api/oauth/access_token T,S,F,R + + +Twitter API funksjoner støttet av StatusNet men for øyeblikket ikke av Friendica eller Red + +* api/favorites T,S +* api/favorites/create T,S +* api/favorites/destroy T,S +* api/statuses/retweets_of_me T,S +* api/friendships/create T,S +* api/friendships/destroy T,S +* api/friendships/exists T,S +* api/friendships/show T,S +* api/account/update_location T,S +* api/account/update_profile_background_image T,S +* api/account/update_profile_image T,S +* api/blocks/create T,S +* api/blocks/destroy T,S + +Twitter API funksjoner som for øyeblikket ikke er støttet av StatusNet + +* api/statuses/retweeted_to_me T +* api/statuses/retweeted_by_me T +* api/direct_messages/destroy T +* api/account/end_session T,(R) +* api/account/update_delivery_device T +* api/notifications/follow T +* api/notifications/leave T +* api/blocks/exists T +* api/blocks/blocking T +* api/lists T + + +StatusNet kompatible utvidelser til Twitter API-et støttet av både Friendica og Red + +* api/statusnet/version S,F,R +* api/statusnet/config S,F,R + +Friendica API utvidelser til Twitter API-et støttet av både Friendica og Red + +* api/statuses/mediap F,R + + +Red-spesifikke API utvidelser til Twitter API-et som ikke er støttet av Friendica + +* api/account/logout R +* api/export/basic R,J +* api/friendica/config R +* api/red/config R +* api/friendica/version R +* api/red/version R + +* api/red/channel/export/basic R,J +* api/red/channel/stream R,J (currently post only) +* api/red/albums R,J +* api/red/photos R,J (option album=xxxx) + + +Foreslåtte Red API utvidelser til Twitter API-et + +* api/statuses/edit (R),J +* api/statuses/permissions (R),J +* api/statuses/permissions/update (R),J +* api/statuses/ids (R),J # søk etter eksisterende message_id før importering av fremmed innlegg +* api/files/show (R),J +* api/files/destroy (R),J +* api/files/update (R),J +* api/files/permissions (R),J +* api/files/permissions/update (R),J +* api/pages/show (R),J +* api/pages/destroy (R),J +* api/pages/update (R),J +* api/pages/permissions (R),J +* api/pages/permissions/update (R),J +* api/events/show (R),J +* api/events/update (R),J +* api/events/permissions (R),J +* api/events/permissions/update (R),J +* api/events/destroy (R),J +* api/photos/show (R),J +* api/photos/update (R),J +* api/photos/permissions (R),J +* api/photos/permissions/update (R),J +* api/albums/destroy (R),J +* api/albums/show (R),J +* api/albums/update (R),J +* api/albums/permissions (R),J +* api/albums/permissions/update (R),J +* api/albums/destroy (R),J +* api/friends/permissions (R),J + + diff --git a/sources/doc/nomadic-identity.bb b/sources/doc/nomadic-identity.bb new file mode 100644 index 00000000..a062e58c --- /dev/null +++ b/sources/doc/nomadic-identity.bb @@ -0,0 +1 @@ +This still needs to be written. diff --git a/sources/doc/permissions.bb b/sources/doc/permissions.bb new file mode 100644 index 00000000..bcf3c43e --- /dev/null +++ b/sources/doc/permissions.bb @@ -0,0 +1,110 @@ +[b]Permissions[/b] + +Permissions in the $Projectname are more complete than you may be used to. This allows us to define more fine graded relationships than the black and white "this person is my friend, so they can do everything" or "this person is not my friend, so they can't do anything" permissions you may find elsewhere. + +[b]Default Permissions[/b] + +On your settings page, you will find a list of default permissions. These permissions are automatically applied to everybody unless you specify otherwise. The scope of these permissions varies from "Only me" to "Everybody" - though some scopes may not be available for some permissions. For example, you can't allow "anybody on the internet" to send you private messages, because we'd have no way to identify the sender, therefore no way to reply to them. + +We highly recommend that you use the "typical social network" settings when you create your first channel, as it allows others to communicate with you and help you out if you have difficulty. You will find that these settings allow you as much privacy as you desire - when you desire it; but also allow you to communicate in public if you choose to. You are free to use much more private settings once you have learned your way around. + +Be aware that altering the scope of who can see your "public" items is a more or less [b]permanent[/b] change. Your public items have no identified permissions attached to them - they are public. If you restrict who can see these items, there is no way of making any single item public ever again - without allowing access to every public item you ever created. You are certainly free to do this, but beware of the consequences. + +A more useful privacy setup is to leave "public" items visible to anybody on the internet; but force everything you create to be restricted. This can be done on your Channel Settings page by selecting the role "Social - restricted". This ensures a Default Privacy Group for all new contacts, and sets your Default Post Permissions to restrict all your posts to that group. We use the Default Post Permissions for everything you create - posts, photos, events, webpages, and everything else. However you can then edit the permissions when you create any individual thing and remove your default privacy group to make just that item visible to anybody. + + + +The scopes of permissions are: + +[li]Nobody Except Yourself. This is self explanatory. Only you will be allowed access.[/li] + +[li]Only those you specifically allow. By default, people you are not connected to, and all new contacts will have this permission denied. You will be able to make exceptions for individual channels on their contact edit screen.[/li] + +[li]Anybody in your address book. Anybody you do not know will have this permission denied, but anybody you accept as a contact will have this permission approved. This is the way most legacy platforms handle permissions.[/li] + +[li]Anybody On This Hub. Anybody using the same hub as you will have permission approved. Anybody who registered at a different hub will have this permission denied.[/li] + +[li]Anybody in this network. Anybody in the $Projectname will have this permission approved. Even complete strangers. However, anybody not logged in/authenticated will have this permission denied.[/li] + +[li]Anybody authenticated. This is similar to "anybody in this network" except that it can include anybody who can authenticate by any means - and therefore may include visitors from other networks.[/li] + +[li]Anybody on the internet. Completely public. This permission will be approved for anybody at all.[/li] + +The individual permissions are: + +[i]Can view my "public" stream and posts.[/i] + +This permision determines who can view your channel "stream" that is, the non-private posts that appear on the "home" tab when you're logged in. + +[i]Can view my "public" channel profile.[/i] + +This permission determines who can view your channel's profile. This refers to the "about" tab + +[i]Can view my "public" photo albums.[/i] + + This permission determines who can view your photo albums. Individual photographs may still be posted to a more private audience. + +[i]Can view my "public" address book.[/i] + +This permission determines who can view your contacts. These are the connections displayed in the "View connections" section. + +[i]Can view my "public" file storage.[/i] + +This permission determines who can view your public files stored in your cloud. + +[i]Can view my "public" pages.[/i] + +This permission determines who can view your public web pages. + +[i]Can send me their channel stream and posts.[/i] + +This permission determines whose posts you will view. If your channel is a personal channel (ie, you as a person), you would probably want to set this to "anyone in my address book" at a minimum. A personal notes channel would probably want to choose "nobody except myself". Setting this to "Anybody in the network" will show you posts from complete strangers, which is a good form of discovery. + +[i]Can post on my channel page ("wall").[/i] + +This permission determines who can write to your wall when clicking through to your channel. + +[i]Can comment on my posts.[/i] + +This permission determines who can comment on posts you create. Normally, you would want this to match your "can view my public stream and posts" permission + +[i]Can send me private mail messages.[/i] + +This determines who can send you private messages (zotmail). + +[i]Can post photos to my photo albums.[/i] + +This determines who can post photographs in your albums. This is very useful for forum-like channels where connections may not be connected to each other. + +[i]Can forward to all my channel contacts via post tags.[/i] + +Using @- mentions will reproduce a copy of your post on the profile specified, as though you posted on the channel wall. This determines if people can post to your channel in this way. + +[i]Can chat with me (when available).[/i] + +This determines who can join the public chat rooms created by your channel. + +[i]Can write to my "public" file storage.[/i] + +This determines who can upload files to your public file storage, or 'cloud'. + +[i]Can edit my "public" pages.[/i] + +This determines who can edit your webpages. This is useful for wikis or sites with multiple editors. + +[i]Can administer my channel resources.[/i] + +This determines who can have full control of your channel. This should normally be set to "nobody except myself". + +[i]Note:[/i] +Plugins/addons may provide special permission settings, so you may be offered additional permission settings beyond what is described here. + +If you have set any of these permissions to "only those I specifically allow", you may specify indivudal permissions on the connnection edit screen. + +[b]Affinity[/b] + +The connection edit screen offers a slider to select a degree of friendship with the connnection (this tool is enabled through the "Extra Features" tab of your Settings page). Think of this as a measure of how much you like or dislike them. 1 is for people you like, whose posts you want to see all the time. 99 is for people you don't care for, and whose posts you might only wish to look at occasionally. Once you've assigned a value here, you can use the affinity tool on the matrix page to filter content based on this number. + +The slider on the matrix page has both a minimum and maximum value. Posts will only be shown from people who fall between this range. Affinity has no relation to permissions, and is only useful in conjunction with the affinity tool feature. + +#include doc/macros/main_footer.bb; diff --git a/sources/doc/plugins.bb b/sources/doc/plugins.bb new file mode 100644 index 00000000..f7427603 --- /dev/null +++ b/sources/doc/plugins.bb @@ -0,0 +1,264 @@ +[b]Plugins[/b] + +So you want to make the $Projectname do something it doesn't already do. There are lots of ways. But let's learn how to write a plugin or addon. + + +In your $Projectname folder/directory, you will probably see a sub-directory called 'addon'. If you don't have one already, go ahead and create it. +[code] + mkdir addon +[/code] +Then figure out a name for your addon. You probably have at least a vague idea of what you want it to do. For our example I'm going to create a plugin called 'randplace' that provides a somewhat random location for each of your posts. The name of your plugin is used to find the functions we need to access and is part of the function names, so to be safe, use only simple text characters. + +Once you've chosen a name, create a directory beneath 'addon' to hold your working file or files. +[code] + mkdir addon/randplace +[/code] +Now create your plugin file. It needs to have the same name, and it's a PHP script, so using your favourite editor, create the file +[code] + addon/randplace/randplace.php +[/code] +The very first line of this file needs to be +[code] + <?php +[/code] +Then we're going to create a comment block to describe the plugin. There's a special format for this. We use /* ... */ comment-style and some tagged lines consisting of +[code] + /** + * + * Name: Random Place (here you can use better descriptions than you could in the filename) + * Description: Sample $Projectname plugin, Sets a random place when posting. + * Version: 1.0 + * Author: Mike Macgirvin <mike@zothub.com> + * + */ +[/code] +These tags will be seen by the site administrator when he/she installs or manages plugins from the admin panel. There can be more than one author. Just add another line starting with 'Author:'. + +The typical plugin will have at least the following functions: +[code] + pluginname_load() + pluginname_unload() +[/code] +In our case, we'll call them randplace_load() and randplace_unload(), as that is the name of our plugin. These functions are called whenever we wish to either initialise the plugin or remove it from the current webpage. Also if your plugin requires things like altering the database schema before it can run for the very first time, you would likely place these instructions in the functions named +[code] + pluginname_install() + pluginname_uninstall() +[/code] + +Next we'll talk about **hooks**. Hooks are places in the $Projectname code where we allow plugins to do stuff. There are a [lot of these](help/Hooks), and they each have a name. What we normally do is use the pluginname_load() function to register a "handler function" for any hooks you are interested in. Then when any of these hooks are triggered, your code will be called. + +We register hook handlers with the 'register_hook()' function. It takes 3 arguments. The first is the hook we wish to catch, the second is the filename of the file to find our handler function (relative to the base of your $Projectname installation), and the third is the function name of your handler function. So let's create our randplace_load() function right now. + +[code] + function randplace_load() { + register_hook('post_local', 'addon/randplace/randplace.php', 'randplace_post_hook'); + + register_hook('feature_settings', 'addon/randplace/randplace.php', 'randplace_settings'); + register_hook('feature_settings_post', 'addon/randplace/randplace.php', 'randplace_settings_post'); + + } +[/code] + +So we're going to catch three events, 'post_local' which is triggered when a post is made on the local system, 'feature_settings' to set some preferences for our plugin, and 'feature_settings_post' to store those settings. + +Next we'll create an unload function. This is easy, as it just unregisters our hooks. It takes exactly the same arguments. +[code] + function randplace_unload() { + unregister_hook('post_local', 'addon/randplace/randplace.php', 'randplace_post_hook'); + + unregister_hook('feature_settings', 'addon/randplace/randplace.php', 'randplace_settings'); + unregister_hook('feature_settings_post', 'addon/randplace/randplace.php', 'randplace_settings_post'); + + } +[/code] + +Hooks are called with two arguments. The first is always $a, which is our global App structure and contains a huge amount of information about the state of the web request we are processing; as well as who the viewer is, and what our login state is, and the current contents of the web page we're probably constructing. + +The second argument is specific to the hook you're calling. It contains information relevant to that particular place in the program, and often allows you to look at, and even change it. In order to change it, you need to add '&' to the variable name so it is passed to your function by reference. Otherwise it will create a copy and any changes you make will be lost when the hook process returns. Usually (but not always) the second argument is a named array of data structures. Please see the "hook reference" (not yet written as of this date) for details on any specific hook. Occasionally you may need to view the program source to see precisely how a given hook is called and how the results are processed. + +Let's go ahead and add some code to implement our post_local hook handler. +[code] + function randplace_post_hook($a, &$item) { + + /** + * + * An item was posted on the local system. + * We are going to look for specific items: + * - A status post by a profile owner + * - The profile owner must have allowed our plugin + * + */ + + logger('randplace invoked'); + + if(! local_channel()) /* non-zero if this is a logged in user of this system */ + return; + + if(local_channel() != $item['uid']) /* Does this person own the post? */ + return; + + if(($item['parent']) || (! is_item_normal($item))) { + /* If the item has a parent, or is not "normal", this is a comment or something else, not a status post. */ + return; + } + + /* Retrieve our personal config setting */ + + $active = get_pconfig(local_channel(), 'randplace', 'enable'); + + if(! $active) + return; + /** + * + * OK, we're allowed to do our stuff. + * Here's what we are going to do: + * load the list of timezone names, and use that to generate a list of world cities. + * Then we'll pick one of those at random and put it in the "location" field for the post. + * + */ + + $cities = array(); + $zones = timezone_identifiers_list(); + foreach($zones as $zone) { + if((strpos($zone,'/')) && (! stristr($zone,'US/')) && (! stristr($zone,'Etc/'))) + $cities[] = str_replace('_', ' ',substr($zone,strpos($zone,'/') + 1)); + } + + if(! count($cities)) + return; + $city = array_rand($cities,1); + $item['location'] = $cities[$city]; + + return; + } +[/code] + +Now let's add our functions to create and store preference settings. +[code] + /** + * + * Callback from the settings post function. + * $post contains the global $_POST array. + * We will make sure we've got a valid user account + * and that only our own submit button was clicked + * and if so set our configuration setting for this person. + * + */ + + function randplace_settings_post($a,$post) { + if(! local_channel()) + return; + if($_POST['randplace-submit']) + set_pconfig(local_channel(),'randplace','enable',intval($_POST['randplace'])); + } + + + + /** + * + * Called from the Feature Setting form. + * The second argument is a string in this case, the HTML content region of the page. + * Add our own settings info to the string. + * + * For uniformity of settings pages, we use the following convention + * <div class="settings-block"> + * <h3>title</h3> + * .... settings html - many elements will be floated... + * <div class="clear"></div> <!-- generic class which clears all floats --> + * <input type="submit" name="pluginnname-submit" class="settings-submit" ..... /> + * </div> + */ + + + + function randplace_settings(&$a,&$s) { + + if(! local_channel()) + return; + + /* Add our stylesheet to the page so we can make our settings look nice */ + + head_add_css(/addon/randplace/randplace.css'); + + /* Get the current state of our config variable */ + + $enabled = get_pconfig(local_channel(),'randplace','enable'); + + $checked = (($enabled) ? ' checked="checked" ' : ''); + + /* Add some HTML to the existing form */ + + $s .= '<div class="settings-block">'; + $s .= '<h3>' . t('Randplace Settings') . '</h3>'; + $s .= '<div id="randplace-enable-wrapper">'; + $s .= '<label id="randplace-enable-label" for="randplace-checkbox">' . t('Enable Randplace Plugin') . '</label>'; + $s .= '<input id="randplace-checkbox" type="checkbox" name="randplace" value="1" ' . $checked . '/>'; + $s .= '</div><div class="clear"></div>'; + + /* provide a submit button */ + + $s .= '<div class="settings-submit-wrapper" ><input type="submit" name="randplace-submit" class="settings-submit" value="' . t('Submit') . '" /></div></div>'; + + } + +[/code] + + + +***Advanced Plugins*** + +Sometimes your plugins want to provide a range of new functionality which isn't provided at all or is clumsy to provide using hooks. In this case your plugin can also act as a 'module'. A module in our case refers to a structured webpage handler which responds to a given URL. Then anything which accesses that URL will be handled completely by your plugin. + +The key to this is to create a simple function named pluginname_module() which does nothing. +[code] + function randplace_module() { return; } +[/code] +Once this function exists, the URL #^[url=https://yoursite/randplace]https://yoursite/randplace[/url] will access your plugin as a module. Then you can define functions which are called at various points to build a webpage just like the modules in the mod/ directory. The typical functions and the order which they are called is +[code] + modulename_init($a) // (e.g. randplace_init($a);) called first - if you wish to emit json or xml, + // you should do it here, followed by killme() which will avoid the default action of building a webpage + modulename_aside($a) // Often used to create sidebar content + modulename_post($a) // Called whenever the page is accessed via the "post" method + modulename_content($a) // called to generate the central page content. This function should return a string + // consisting of the central page content. +[/code] +Your module functions have access to the URL path as if they were standalone programs in the Unix operating system. For instance if you visit the page +[code] + https://yoursite/randplace/something/somewhere/whatever +[/code] +we will create an argc/argv list for use by your module functions +[code] + $x = argc(); $x will be 4, the number of path arguments after the sitename + + for($x = 0; $x < argc(); $x ++) + echo $x . ' ' . argv($x); + + + 0 randplace + 1 something + 2 somewhere + 3 whatever +[/code] + +If you want to keep your plugin hidden from the siteinfo page, simply create a file called '.hidden' in your addon directory +[code] + touch addon/
+ Block Content
+
+
+[/code]
+
+If a block has text/html content type it can also contain menu elements. Sample content of
+[code]
+ HTML block content
+ [menu]menuname[/menu] + +[/code] +will produce HTML like this +[code] + + +[/code] + +Via the $content macro a block can also contain the actual webpage content. For this create a block with only +[code] + $content + +[/code]as content. + +To make a block appear in the webpage it must be defined in the page layout inside a region. +[code] + [region=aside] + [block]blockname[/block] + [/region] + +[/code] + +The block appearance can be manipulated in the page layout. + +Custom classes can be assigned +[code] + [region=aside] + [block=myclass]blockname[/block] + [/region] + +[/code] +will produce this HTML +[code] +
+ Block Content
+
+
+[/code]
+
+Via the wrap variable a block can be stripped off its wrapping tag
+[code]
+ [region=aside]
+ [block][var=wrap]none[/var]blockname[/block]
+ [/region]
+
+[/code]
+will produce this HTML
+[code]
+ Block Content
+
+[/code]
+
+
+#include doc/macros/main_footer.bb;
+
diff --git a/sources/doc/what_is_zot.bb b/sources/doc/what_is_zot.bb
new file mode 100644
index 00000000..50df9e39
--- /dev/null
+++ b/sources/doc/what_is_zot.bb
@@ -0,0 +1,61 @@
+[b]What is Zot?[/b]
+
+Zot is the protocol that powers the $Projectname, providing three core capabilities: Communications, Identity, and Access Control.
+
+The functionality it provides can also be described as follows:
+
+ - a relationship online is just a bunch of permissions
+ - the internet is just another folder
+
+[b][size=20]Communications[/size][/b]
+
+Zot is a revolutionary protocol which provides [i]decentralised communications[/i] and [i]identity management[/i] across the matrix. The resulting platform can provide web services comparable to those offered by large corporate providers, but without the large corporate provider and their associated privacy issues, insatiable profit drive, and walled-garden mentality.
+
+Communications and social networking are an integral part of the matrix. Any channel (and any services provided by that channel) can make full use of feature-rich social communications on a global scale. These communications may be public or private - and private communications comprise not only fully encrypted transport, but also encrypted storage to help protect against accidental snooping and disclosure by rogue system administrators and internet service providers.
+
+Zot allows a wide array of background services in the matrix, from offering friend suggestions, to directory services. You can also perform other things which would typically only be possibly on a centralized provider - such as "Wall to Wall" posts. Priivate/multiple profiles can be easily created, and web content can be tailored to the viewer via the [i]Affinity Slider[/i].
+
+You won't find these features at all on other decentralized communication services. In addition to providing hub (server) decentralization, perhaps the most innovative and interesting Zot feature is its provision of [i]decentralized identity[/i] services.
+
+[b][size=20]Identity[/size][/b]
+
+Zot's identity layer is unique. It provides [i]invisible single sign-on[/i] across all sites in the matrix.
+
+It also provides [i]nomadic identity[/i], so that your communications with friends, family, and or anyone else you're communicating with won't be affected by the loss of your primary communication node - either temporarily or permanently.
+
+The important bits of your identity and relationships can be backed up to a thumb drive, or your laptop, and may appear at any node in the matrix at any time - with all your friends and preferences intact.
+
+Crucially, these nomadic instances are kept in sync so any instance can take over if another one is compromised or damaged. This protects you against not only major system failure, but also temporary site overloads and governmental manipulation or censorship.
+
+Nomadic identity, single sign-on, and Red's decentralization of hubs, we believe, introduce a high degree of degree of [i]resiliency[/i] and [i]persistence[/i] in internet communications, that are sorely needed amidst global trends towards corporate centralization, as well as mass and indiscriminate government surveillance and censorship.
+
+As you browse the matrix, viewing channels and their unique content, you are seamlessly authenticated as you go, even across completely different server hubs. No passwords to enter. Nothing to type. You're just greeted by name on every new site you visit.
+
+How does Zot do that? We call it [i]magic-auth[/i], because Red hides the details of the complexities that go into single sign-on logins, and nomadic identities, from the experience of browsing on the matrix. This is one of the design goals of Red: to increase privacy, and freedom on the web, while reducing the complexity and tedium brought by the need to enter new passwords and user names for every different sight that someone might visit online.
+
+You login only once on your home hub (or any nomadic backup hub you have chosen). This allows you to access any authenticated services provided anywhere in the matrix - such as shopping, blogs, forums, and access to private information. This is just like the services offered by large corporate providers with huge user databases; however you can be a member of this community, as well as a server on this network using a $35 Rasberry Pi. Your password isn't stored on a thousand different sites, or even worse, only on a few sites like Google and Facebook, beyond your direct control.
+
+You cannot be silenced. You cannot be removed from the matrix, unless you yourself choose to exit it.
+
+[b][size=20]Access Control[/size][/b]
+
+Zot's identity layer allows you to provide fine-grained permissions to any content you wish to publish - and these permissions extend across the $Projectname. This is like having one super huge website made up of an army of small individual websites - and where each channel in the matrix can completely control their privacy and sharing preferences for any web resources they create.
+
+Currently, the matrix supports communications, photo albums, events, and files. This will be extended in the future to provide content management services (web pages) and cloud storage facilities, such as WebDAV and multi-media libraries. Every object and how it is shared and with whom is completely under your control.
+
+This type of control is available on large corporate providers such as Facebook and Google, because they own the user database. Within the matrix, there is no need for a huge user databaseon your machine - because the matrix [i]is[/i] your user database. It has what is essentially infinite capacity (limited by the total number of hubs online across the internet), and is spread amongst hundreds, and potentially millions of computers.
+
+Access can be granted or denied for any resource, to any channel, or any group of channels; anywhere within the matrix. Others can access your content if you permit them to do so, and they do not even need to have an account on your hub. Your private photos cannot be viewed, because permission really work; they are not an addon that was added as an afterthought. If you aren't on the list of allowed viewers for a particular photo, you aren't going to look at it.
+
+[b][size=18]Additional Resources and Links[/size][/b]
+
+For more detailed, technical information about Zot, check out the following links:
+
+ - [url=https://github.com/friendica/red/wiki/Zot---A-High-Level-Overview]A high level overview[/url]
+
+ - [url=https://github.com/friendica/red/wiki/zot]Zot development specification[/url]
+
+ - [url=https://github.com/redmatrix/hubzilla/blob/master/include/zot.php]Zot reference implementation in PHP[/url]
+
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/zot.md b/sources/doc/zot.md
new file mode 100644
index 00000000..f8881c55
--- /dev/null
+++ b/sources/doc/zot.md
@@ -0,0 +1,400 @@
+Intro to Zot
+============
+
+Zot is a JSON-based web framework for implementing secure decentralised communications and services.
+
+It differs from many other communication protocols by building communications on top of a decentralised identity and authentication framework.
+
+The authentication component is similar to OpenID conceptually but is insulated from DNS-based identities. Where possible remote authentication is silent and invisible. This provides a mechanism for internet scale distributed access control which is unobtrusive.
+
+For example,
+
+Jaquelina wishes to share photos with Roberto from her blog at "jaquelina.com.xyz", but to nobody else. Roberto maintains his own family website at "roberto.com.xyz". Zot allows Jaquelina to create an access list containing "Roberto" and allow Roberto unhindered access to the photos but without allowing Roberto's brother Marco to see the photos.
+
+Roberto will only login once to his own website at roberto.com.xyz using his password. After this, no further passwords will be asked for. Marco may also have an account on roberto.com.xyz, but he is not allowed to see Jaquelina's photos.
+
+
+Additionally, zot allows Roberto to use another site - gadfly.com.xyz, and after login to gadfly.com.xyz he can also access Jaquelina's private photos. Jaquelina does not have to do anything extra to allow this, as she has already given access rights of her private photos to Roberto - no matter what site he is logged into.
+
+Zot also allows basic messaging and communications with anybody else on the Zot network.
+
+In order to provide this functionality, zot creates a decentralised globally unique identifier for each node on the network. This global identifier is not linked inextricably to DNS, providing the requisite mobility. Many existing decentralised communications frameworks provide the communication aspect, but do not provide remote access control and authentication. Additionally most of these are based on 'webfinger' such that in our example, Roberto would only be recognised if he accessed Jaquelina's photos from roberto.com.xyz - but not from gadfly.com.xyz.
+
+
+The primary issues zot addresses are
+
+* completely decentralised communications
+* insulation from DNS based identity
+* node mobility
+* invisible or reduced "interaction" remote authentication
+* high performance
+
+We will rely on DNS-based user@host addresses as a "user-friendly" mechanism to let people know where you are, specifically on a named host with a given username, and communication will be carried out to DNS entities using TCP and the web.
+
+But the underlying protocol will provide an abstraction layer on top of this, so that a communications node (e.g. "identity") can move to an alternate DNS location and (to the best of our ability) gracefully recover from site re-locations and/or maintain pre-existing communication relationships. A side effect of this requirement is the ability to communicate from alternate/multiple DNS locations and service providers and yet maintain a single online identity.
+
+We will call this overlay network the "grid". Servers attached to this network are known as "hubs" and may support any number of individual identities.
+
+An identity does not necessarily correspond to a person. It is just something which requires the ability to communicate within the grid.
+
+The ability to recover will be accomplished by communication to the original location when creating a new or replacement identity, or as a fallback from a stored file describing the identity and their contacts in the case where the old location no longer responds.
+
+At least on the short term, the mobility of existing content is not a top priority. This may or may not take place at a later stage. The most important things we want to keep are your identity and your friends.
+
+Addresses which are shared amongst people are user@host, and which describe the **current** local account credentials for a given identity. These are DNS based addresses and used as a seed to locate a given identity within the grid. The machine communications will bind this address to a globally unique ID. A single globally unique ID may be attached or bound to any number of DNS locations. Once an identity has been mapped or bound to a DNS location, communications will consist of just knowing the globally unique address, and what DNS (url) is being used currently (in order to call back and verify/complete the current communication). These concepts will be specified in better detail.
+
+In order for an identity to persist across locations, one must be able to provide or recover
+
+* the globally unique ID for that identity
+* the private key assigned to that identity
+* (if the original server no longer exists) an address book of contacts for that identity.
+
+This information will be exportable from the original server via API, and/or downloadable to disk or thumb-drive.
+
+We may also attempt to recover with even less information, but doing so is prone to account hijacking and will require that your contacts confirm the change.
+
+In order to implement high performance communications, the data transfer format for all aspects of zot is JSON. XML communications require way too much overhead.
+
+Bi-directional encryption is based on RSA 4096-bit keys expressed in DER/ASN.1 format using the PKCS#8 encoding variant, with AES-256-CBC used for block encryption of variable length or large items.
+
+Some aspects of well known "federation protocols" (webfinger, salmon, activitystreams, portablecontacts, etc.) may be used in zot, but we are not tied to them and will not be bound by them. The $Projectname project is attempting some rather novel developments in decentralised communications and if there is any need to diverge from such "standard protocols" we will do so without question or hesitation.
+
+In order to create a globally unique ID, we will base it on a whirlpool hash of the identity URL of the origination node and a psuedo-random number, which should provide us with a 256 bit ID with an extremely low probability of collision (256 bits represents approximately 115 quattuorviginitillion or 1.16 X 10^77 unique numbers). This will be represented in communications as a base64url-encoded string. We will not depend on probabilities however and the ID must also be attached to a public key with public key cryptography used to provide an assurance of identity which has not been copied or somehow collided in whirlpool hash space.
+
+Basing this ID on DNS provides a globally unique seed, which would not be the case if it was based completely on psuedo-random number generation.
+
+We will refer to the encoded globally unique uid string as zot_uid
+
+As there may be more than one DNS location attached/bound to a given zot_uid identity, delivery processes should deliver to all of them - as we do not know for sure which hub instance may be accessed at any given time. However we will designate one DNS location as "primary" and which will be the preferred location to view web profile information.
+
+We must also provide the ability to change the primary to a new location. A look-up of information on the current primary location may provide a "forwarding pointer" which will tell us to update our records and move everything to the new location. There is also the possibility that the primary location is defunct and no longer responding. In that case, a location which has already been mapped to this zot_uid can seize control, and declare itself to be primary. In both cases the primary designation is automatically approved and moved. A request can also be made from a primary location which requests that another location be removed.
+
+In order to map a zot_uid to a second (or tertiary) location, we require a secure exchange which verifies that the new location is in possession of the private key for this zot_uid. Security of the private key is thus essential to avoid hijacking of identities.
+
+Communications will then require
+
+* zot_uid (string)
+* uid_sig
+* callback (current location zot endpoint url)
+* callback_sig
+* spec (int)
+
+passed with every communique. The spec is a revision number of the applicable zot spec so that communications can be maintained with hubs using older and perhaps incompatible protocol specifications. Communications are verified using a stored public key which was copied when the connection to this zot_uid was first established.
+
+Key revocation and replacement must take place from the primary hub. The exact form for this is still being worked out, but will likely be a notification to all other bound hubs to "phone home" (to the primary hub) and request a copy of the new key. This communique should be verified using a site or hub key; as the original identity key may have been compromised and cannot be trusted.
+
+In order to eliminate confusion, there should be exactly one canonical url for any hub, so that these can be indexed and referenced without ambiguity.
+
+So as to avoid ambiguity of scheme, it is strongly encouraged that all addresses to be https with a "browser valid" cert and a single valid host component (either www.domain.ext or domain.ext, but not both), which is used in all communications. Multiple URLs may be provided locally, but only one unique URL should be used for all zot communications within the grid.
+
+Test installation which do not connect to the public grid may use non-SSL, but all traffic flowing over public networks should be safe from session-hijacking, preferably with a "browser recognised" cert.
+
+Where possible, zot encourages the use of "batching" to minimise network traffic between two hubs. This means that site 'A' can send multiple messages to site 'B' in a single transaction, and also consolidate deliveries of identical messages to multiple recipients on the same hub.
+
+Messages themselves may or may not be encrypted in transit, depending on the private nature of the messages. SSL (strongly encouraged) provides unconditional encryption of the data stream, however there is little point in encrypting public communications which have been designated as having unrestricted visibility. The encryption of data storage and so-called "end-to-end encryption" is outside the scope of zot. It is presumed that hub operators will take adequate safeguards to ensure the security of their data stores and these are functions of application and site integrity as opposed to protocol integrity.
+
+
+## Messages
+
+Given the constraints listed previously, a zot communique should therefore be a json array of individual messages. These can be mixed and combined within the same transmission.
+
+Each message then requires:
+
+* type
+* (optional) recipient list
+
+Lack of a recipient list would indicate an unencrypted public or site level message. The recipient list would contain an array of zot_uid with an individual decryption key, and a common iv. The decryption key is encoded with the recipient identity's public key. The iv is encrypted with the sender's private key.
+
+All messages should be digitally signed by the sender.
+
+The type can be one of (this list is extensible):
+
+* post (or activity)
+* mail
+* identity
+* authenticate
+
+Identity messages have no recipients and notify the system social graph of an identity update, which could be a new or deleted identity, a new or deleted location, or a change in primary hub. The signature for these messages uses system keys as opposed to identity-specific keys.
+
+Posts include many different types of activities, such as top-level posts, likes/dislikes, comments, tagging activities, etc. These types are indicated within the message sturcture.
+
+authenticate messages result in mutual authentication and browser redirect to protected resources on the remote hub such as the ability to post wall-to-wall messages and view private photo albums and events, etc.
+
+## Discovery
+
+A well-known url is used to probe a hub for zot capabilities and identity lookups, including the discovery of public keys, profile locations, profile photos, and primary hub location.
+
+The location for this service is /.well-known/zot-info - and must be available at the root of the chosen domain.
+
+To perform a lookup, a POST request is made to the discovery location with the following parameters:
+
+Required:
+
+address => an address on the target system such as "john"
+
+Optional
+
+target => the zot "guid" of the observer for evaluating permissions
+
+target_sig => an RSA signature (base64url encoded) of the guid
+
+key => The public key needed to verify the signature
+
+With no target provided, the permissions returned will be generic permissions
+for unknown or unauthenticated observers
+
+Example of discovery packet for 'mike@zothub.com'
+
+ {
+
+ "success": true,
+ "guid": "sebQ-IC4rmFn9d9iu17m4BXO-kHuNutWo2ySjeV2SIW1LzksUkss12xVo3m3fykYxN5HMcc7gUZVYv26asx-Pg",
+ "guid_sig": "Llenlbl4zHo6-g4sa63MlQmTP5dRCrsPmXHHFmoCHG63BLq5CUZJRLS1vRrrr_MNxr7zob_Ykt_m5xPKe5H0_i4pDj-UdP8dPZqH2fqhhx00kuYL4YUMJ8gRr5eO17vsZQ3XxTcyKewtgeW0j7ytwMp6-hFVUx_Cq08MrXas429ZrjzaEwgTfxGnbgeQYQ0R5EXpHpEmoERnZx77VaEahftmdjAUx9R4YKAp13pGYadJOX5xnLfqofHQD8DyRHWeMJ4G1OfWPSOlXfRayrV_jhnFlZjMU7vOdQwHoCMoR5TFsRsHuzd-qepbvo3pzvQZRWnTNu6oPucgbf94p13QbalYRpBXKOxdTXJrGdESNhGvhtaZnpT9c1QVqC46jdfP0LOX2xrVdbvvG2JMWFv7XJUVjLSk_yjzY6or2VD4V6ztYcjpCi9d_WoNHruoxro_br1YO3KatySxJs-LQ7SOkQI60FpysfbphNyvYMkotwUFI59G08IGKTMu3-GPnV1wp7NOQD1yzJbGGEGSEEysmEP0SO9vnN45kp3MiqbffBGc1r4_YM4e7DPmqOGM94qksOcLOJk1HNESw2dQYWxWQTBXPfOJT6jW9_crGLMEOsZ3Jcss0XS9KzBUA2p_9osvvhUKuKXbNztqH0oZIWlg37FEVsDs_hUwUJpv2Ar09k4",
+ "key": "-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA7QCwvuEIwCHjhjbpz3Oc\ntyei/Pz9nDksNbsc44Cm8jxYGMXsTPFXDZYCcCB5rcAhPPdZSlzaPkv4vPVcMIrw\n5cdX0tvbwa3rNTng6uFE7qkt15D3YCTkwF0Y9FVZiZ2Ko+G23QeBt9wqb9dlDN1d\nuPmu9BLYXIT/JXoBwf0vjIPFM9WBi5W/EHGaiuqw7lt0qI7zDGw77yO5yehKE4cu\n7dt3SakrXphL70LGiZh2XGoLg9Gmpz98t+gvPAUEotAJxIUqnoiTA8jlxoiQjeRK\nHlJkwMOGmRNPS33awPos0kcSxAywuBbh2X3aSqUMjcbE4cGJ++/13zoa6RUZRObC\nZnaLYJxqYBh13/N8SfH7d005hecDxWnoYXeYuuMeT3a2hV0J84ztkJX5OoxIwk7S\nWmvBq4+m66usn6LNL+p5IAcs93KbvOxxrjtQrzohBXc6+elfLVSQ1Rr9g5xbgpub\npSc+hvzbB6p0tleDRzwAy9X16NI4DYiTj4nkmVjigNo9v2VPnAle5zSam86eiYLO\nt2u9YRqysMLPKevNdj3CIvst+BaGGQONlQalRdIcq8Lin+BhuX+1TBgqyav4XD9K\nd+JHMb1aBk/rFLI9/f2S3BJ1XqpbjXz7AbYlaCwKiJ836+HS8PmLKxwVOnpLMbfH\nPYM8k83Lip4bEKIyAuf02qkCAwEAAQ==\n-----END PUBLIC KEY-----\n",
+ "name": "Mike Macgirvin",
+ "name_updated": "2012-12-06 04:59:13",
+ "address": "mike@zothub.com",
+ "photo_mimetype": "image/jpeg",
+ "photo": "https://zothub.com/photo/profile/l/1",
+ "photo_updated": "2012-12-06 05:06:11",
+ "url": "https://zothub.com/channel/mike",
+ "connections_url": "https://zothub.com/poco/mike",
+ "target": "",
+ "target_sig": "",
+ "searchable": false,
+ "permissions": {
+ "view_stream": true,
+ "view_profile": true,
+ "view_photos": true,
+ "view_contacts": true,
+ "view_storage": true,
+ "view_pages": true,
+ "send_stream": false,
+ "post_wall": false,
+ "post_comments": false,
+ "post_mail": false,
+ "post_photos": false,
+ "tag_deliver": false,
+ "chat": false,
+ "write_storage": false,
+ "write_pages": false,
+ "delegate": false
+ },
+ "profile": {
+ "description": "Freedom Fighter",
+ "birthday": "0000-05-14",
+ "next_birthday": "2013-05-14 00:00:00",
+ "gender": "Male",
+ "marital": "It's complicated",
+ "sexual": "Females",
+ "locale": "",
+ "region": "",
+ "postcode": "",
+ "country": "Australia"
+ },
+ "locations": [
+ {
+ "host": "zothub.com",
+ "address": "mike@zothub.com",
+ "primary": true,
+ "url": "https://zothub.com",
+ "url_sig": "eqkB_9Z8nduBYyyhaSQPPDN1AhSm5I4R0yfcFxPeFpuu17SYk7jKD7QzvmsyahM5Kq7vDW6VE8nx8kdFYpcNaurqw0_IKI2SWg15pGrhkZfrCnM-g6A6qbCv_gKCYqXvwpSMO8SMIO2mjQItbBrramSbWClUd2yO0ZAceq3Z_zhirCK1gNm6mGRJaDOCuuTQNb6D66TF80G8kGLklv0o8gBfxQTE12Gd0ThpUb5g6_1L3eDHcsArW_RWM2XnNPi_atGNyl9bS_eLI2TYq0fuxkEdcjjYx9Ka0-Ws-lXMGpTnynQNCaSFqy-Fe1aYF7X1JJVJIO01LX6cCs-kfSoz29ywnntj1I8ueYldLB6bUtu4t7eeo__4t2CUWd2PCZkY3PKcoOrrnm3TJP5_yVFV_VpjkcBCRj3skjoCwISPcGYrXDufJxfp6bayGKwgaCO6QoLPtqqjPGLFm-fbn8sVv3fYUDGilaR3sFNxdo9mQ3utxM291XE2Pd0jGgeUtpxZSRzBuhYeOybu9DPusID320QbgNcbEbEImO8DuGIxuVRartzEXQF4WSYRdraZzbOqCzmU0O55P836JAfrWjgxTQkXlYCic-DBk-iE75JeT72smCtZ4AOtoFWCjZAABCw42J7JELY9APixZXWriKtjy6JI0G9d3fs6r7SrXr1JMy0",
+ "callback": "https://zothub.com/post",
+ "sitekey": "-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA1IWXwd/BZuevq8jzNFoR\n3VkenduQH2RpR3Wy9n4+ZDpbrUKGJddUGm/zUeWEdKMVkgyllVA/xHdB7jdyKs1X\nuIet9mIdnzvhdLO/JFD5hgbNG2wpSBIUY6aSNeCFTzszqXmuSXMW5U0Ef5pCbzEA\nnhoCoGL1KAgPqyxnGKUlj7q2aDwC9IRNtAqNyFQL67oT91vOQxuMThjlDhbR/29Q\ncYR4i1RzyahgEPCnHCPkT2GbRrkAPjNZAdlnk9UesgP16o8QB3tE2j50TVrbVc/d\nYRbzC56QMPP9UgUsapNeSJBHji75Ip/E5Eg/kfJC/HEQgyCqjCGfb7XeUaeQ7lLO\nqc7CGuMP+Jqr/cE54/aSHg8boTwxkMp11Ykb+ng17fl57MHTM2RJ99qZ1KBkXezR\nuH1lyvjzeJPxEFr9rkUqc4GH74/AgfbgaFvQc8TS7ovEa5I/7Pg04m7vLSEYc6UF\nYJYxXKrzmZT2TDoKeJzaBBx5MFLhW19l68h9dQ8hJXIpTP0hJrpI+Sr6VUAEfFQC\ndIDRiFcgjz6j7T/x8anqh63/hpsyf2PMYph1+4/fxtSCWJdvf+9jCRM8F1IDfluX\n87gm+88KBNaklYpchmGIohbjivJyru41CsSLe0uinQFvA741W00w6JrcrOAX+hkS\nRQuK1dDVwGKoIY85KtTUiMcCAwEAAQ==\n-----END PUBLIC KEY-----\n"
+ }
+ ],
+ "site": {
+ "url": "https://zothub.com",
+ "directory_mode": "primary",
+ "directory_url": "https://zothub.com/dirsearch"
+ }
+
+ }
+
+
+
+Discovery returns a JSON array with the following components:
+
+'success' => ('1' or '') Operation was successful if '1'. Otherwise an optional 'message' may be present indicating the source of error.
+
+'guid' => the guid of the address on the target system
+
+'guid_sig' => the base64url encoded RSA signature of the guid, signed with the private key associated with that guid.
+
+'key' => the public key associated with that guid
+
+'name' => channel name
+
+'name_updated' => MySQL style timestamp '2012-01-01 00:00:00' when the name was last changed (UTC)
+
+'address' => "webbie" or user@host address associated with this channel
+
+'photo' => URL of a profile photo for this channel (ideally 175x175)
+
+'photo_mimetype' => content-type of the profile photo
+
+'photo_updated' => MySQL style timestamp when photo was last updated (UTC)
+
+'url' => location of channel homepage
+
+'connections_url' => location of Portable Contacts (extended for zot) URL for this channel
+
+'target' => if a permissions target was specified, it is mirrored
+
+'target_sig' => if a permissions target was specified, the signature is mirrored.
+
+'searchable' => ('1' or '') '1' indicates this entry can be searched in a directory
+
+###Permissions
+
+
+'permisssions' => extensible array of permissions appropriate to this target, values are '1' or ''
+
+ Permissions may include:
+
+* view_stream
+
+* view_profile
+
+* view_photos
+
+* view_contacts
+
+* view_storage
+
+* view_pages
+
+* send_stream
+
+* post_wall
+
+* post_comments
+
+* post_mail
+
+* post_photos
+
+* tag_deliver
+
+* chat
+
+* write_storage
+
+* write_pages
+
+* delegate
+
+
+
+###Profile
+
+
+'profile' => array of important profile fields
+
+* description
+
+* birthday YYYY-MM-DD , all fields are optional, any field (such as year) may be zero
+
+* next_birthday => MySQL datetime string representing the next upcoming birthday, converted from the channel's default timezone to UTC.
+
+* gender (free form)
+
+* marital (marital status)
+
+* sexual (preference)
+
+* locale (city)
+
+* region (state)
+
+* postcode
+
+* country
+
+
+###Locations
+
+
+'locations' => array of registered locations (DNS locations) this channel may be visible or may be posting from
+
+Each location is an array of
+
+'host' => DNS hostname, e.g. example.com
+
+'address' => the webbie or user@host identifier associated with this location
+
+'primary' => ('1' or '') whether or not this is the primary location for this channel where files and web pages are generally found
+
+'url' => url of the root of this DNS location e.g. https://example.com
+
+'url_sig' => base64url encoded RSA signature of the URL, signed with the channel private key
+
+'callback' => zot communications endpoint on this site, usually https://example.com/post
+
+'sitekey' => public key of this site/host
+
+
+###Site
+
+
+'site' => array providing the directory role of the site responding to this request
+
+'url' => url of this site e.g. https://example.com
+
+'directory_mode' => one of 'primary', 'secondary', 'normal', or 'standalone'
+
+'directory_url' => if this is a directory server or standalone, the URL for the directory search module
+
+
+
+Magic Auth
+==========
+
+
+So-called "magic auth" takes place by a special exchange. On the remote computer, a redirection is made to the zot endpoint with special GET parameters.
+
+Endpoint: https://example.com/post/name
+
+where 'name' is the left hand side of the channel webbie, for instance 'mike' where the webbie is 'mike@zothub.com'
+
+Additionally four parameters are supplied:
+
+* auth => the webbie of the person requesting access
+* dest => the desired destination URL (urlencoded)
+* sec => a random string which is also stored locally for use during the verification phase.
+* version => the zot revision
+
+When this packet is received, a zot message is initiated to the auth identity:
+
+
+ {
+ "type":"auth_check",
+ "sender":{
+ "guid":"kgVFf_1_SSbyqH-BNWjWuhAvJ2EhQBTUdw-Q1LwwssAntr8KTBgBSzNVzUm9_RwuDpxI6X8me_QQhZMf7RfjdA",
+ "guid_sig":"PT9-TApzpm7QtMxC63MjtdK2nUyxNI0tUoWlOYTFGke3kNdtxSzSvDV4uzq_7SSBtlrNnVMAFx2_1FDgyKawmqVtRPmT7QSXrKOL2oPzL8Hu_nnVVTs_0YOLQJJ0GYACOOK-R5874WuXLEept5-KYg0uShifsvhHnxnPIlDM9lWuZ1hSJTrk3NN9Ds6AKpyNRqf3DUdz81-Xvs8I2kj6y5vfFtm-FPKAqu77XP05r74vGaWbqb1r8zpWC7zxXakVVOHHC4plG6rLINjQzvdSFKCQb5R_xtGsPPfvuE24bv4fvN4ZG2ILvb6X4Dly37WW_HXBqBnUs24mngoTxFaPgNmz1nDQNYQu91-ekX4-BNaovjDx4tP379qIG3-NygHTjFoOMDVUvs-pOPi1kfaoMjmYF2mdZAmVYS2nNLWxbeUymkHXF8lT_iVsJSzyaRFJS1Iqn7zbvwH1iUBjD_pB9EmtNmnUraKrCU9eHES27xTwD-yaaH_GHNc1XwXNbhWJaPFAm35U8ki1Le4WbUVRluFx0qwVqlEF3ieGO84PMidrp51FPm83B_oGt80xpvf6P8Ht5WvVpytjMU8UG7-js8hAzWQeYiK05YTXk-78xg0AO6NoNe_RSRk05zYpF6KlA2yQ_My79rZBv9GFt4kUfIxNjd9OiV1wXdidO7Iaq_Q",
+ "url":"http:\/\/podunk.edu",
+ "url_sig":"T8Bp7j5DHHhQDCFcAHXfuhUfGk2P3inPbImwaXXF1xJd3TGgluoXyyKDx6WDm07x0hqbupoAoZB1qBP3_WfvWiJVAK4N1FD77EOYttUEHZ7L43xy5PCpojJQmkppGbPJc2jnTIc_F1vvGvw5fv8gBWZvPqTdb6LWF6FLrzwesZpi7j2rsioZ3wyUkqb5TDZaNNeWQrIEYXrEnWkRI_qTSOzx0dRTsGO6SpU1fPWuOOYMZG8Nh18nay0kLpxReuHCiCdxjXRVvk5k9rkcMbDBJcBovhiSioPKv_yJxcZVBATw3z3TTE95kGi4wxCEenxwhSpvouwa5b0hT7NS4Ay70QaxoKiLb3ZjhZaUUn4igCyZM0h6fllR5I6J_sAQxiMYD0v5ouIlb0u8YVMni93j3zlqMWdDUZ4WgTI7NNbo8ug9NQDHd92TPmSE1TytPTgya3tsFMzwyq0LZ0b-g-zSXWIES__jKQ7vAtIs9EwlPxqJXEDDniZ2AJ6biXRYgE2Kd6W_nmI7w31igwQTms3ecXe5ENI3ckEPUAq__llNnND7mxp5ZrdXzd5HHU9slXwDShYcW3yDeQLEwAVomTGSFpBrCX8W77n9hF3JClkWaeS4QcZ3xUtsSS81yLrp__ifFfQqx9_Be89WVyIOoF4oydr08EkZ8zwlAsbZLG7eLXY"
+ },
+ "recipients":{
+ {
+ "guid":"ZHSqb3yGar3TYV_o9S-JkD-6o_V4DhUcxtv0VeyX8Kj_ENHPI_M3SyAUucU835-mIayGMmTpqJz3ujPkcavVhA",
+ "guid_sig":"JsAAXigNghTkkbq8beGMJjj9LBKZn28hZ-pHSsoQuwYWvBJ2lSnfc4r9l--WgO6sucH-SR6RiBo78eWn1cZrh_cRMu3x3LLx4y-tjixg-oOOgtZakkBg4vmOhkKPkci0mFtzvUrpY4YHySqsWTuPwRx_vOlIYIGEY5bRXpnkNCoC8J4EJnRucDrgSARJvA8QQeQQL0H4mWEdGL7wlsZp_2VTC6nEMQ48Piu6Czu5ThvLggGPDbr7PEMUD2cZ0jE4SeaC040REYASq8IdXIEDMm6btSlGPuskNh3cD0AGzH2dMciFtWSjmMVuxBU59U1I6gHwcxYEV6BubWt_jQSfmA3EBiPhKLyu02cBMMiOvYIdJ3xmpGoMY1Cn__vhHnx_vEofFOIErb6nRzbD-pY49C28AOdBA5ffzLW3ss99d0A-6GxZmjsyYhgJu4tFUAa7JUl84tMbq28Tib0HW6qYo6QWw8K1HffxcTpHtwSL5Ifx0PAoGMJsGDZDD1y_r9a4vH5pjqmGrjL3RXJJUy-m4eLV5r7xMWXsxjqu3D8r04_dcw4hwwexpMT1Nwf8CTB0TKb8ElgeOpDFjYVgrqMYWP0XdhatcFtAJI7gsS-JtzsIwON9Kij66-VAkqy_z1IXI0ziyqV1yapSVYoUV1vMScRZ_nMqwiB5rEDx-XLfzko"
+ }
+ }
+ "callback":"\/post",
+ "version":1,
+ "secret":"1eaa6613699be6ebb2adcefa5379c61a3678aa0df89025470fac871431b70467",
+ "secret_sig":"eKV968b1sDkOVdSMi0tLRtOhQw4otA8yFKaVg6cA4I46_zlAQGbFptS-ODiZlSAqR7RiiZQv4E2uXCKar52dHo0vvNKbpOp_ezWYcwKRu1shvAlYytsflH5acnDWL-FKOOgz5zqLLZ6cKXFMoR1VJGG_Od-DKjSwajyV9uVzTry58Hz_w0W2pjxwQ-Xv11rab5R2O4kKSW77YzPG2R5E6Q7HN38FrLtyWD_ai3K9wlsFOpwdYC064dk66X7BZtcIbKtM6zKwMywcfJzvS5_0U5yc5GGbIY_lY6SViSfx9shOKyxkEKHfS29Ynk9ATYGnwO-jnlMqkJC7t149H-sI9hYWMkLuCzaeLP56k2B2TmtnYvE_vHNQjzVhTwuHCIRVr-p6nplQn_P3SkOpYqPi3k_tnnOLa2d3Wtga8ClEY90oLWFJC3j2UkBf_VEOBNcg-t5XO3T-j9O4Sbk96k1Qoalc-QlznbGx4bOVsGkRBBMiH4YUqiiWB_OkFHtdqv7dqGeC-u-B4u9IxzYst46vvmyA3O-Q4APSZ1RY8ITUH0jLTbh6EAV7Oki8pIbOg0t56p-8RlanOZqmFvR-grVSc7Ak1ZcD8NACmvidUpa1B7WEvRcOeffx9lype0bt5XenDnMyx6szevwxZIiM8qGM2lsSk4fu8HI9cW0mLywzZT0"
+ }
+
+
+auth_check messages MUST be encrypted with AES256CBC. This message is sent to the origination site, which checks the 'secret' to see if it is the same as the 'sec' which it passed originally. It also checks the secret_sig which is the secret signed by the destination channel's private key and base64url encoded. If everything checks out, a json packet is returned:
+
+ {
+ "success":1,
+ "confirm":"q0Ysovd1uQRsur2xG9Tg6bC23ynzw0191SkVd7CJcYoaePy6e_v0vnmPg2xBUtIaHpx_aSuhgAkd3aVjPeaVBmts6aakT6a_yAEy7l2rBydntu2tvrHhoVqRNOmw0Q1tI6hwobk1BgK9Pm0lwOeAo8Q98BqIJxf47yO9pATa0wktOg6a7LMogC2zkkhwOV5oEqjJfeHeo27TiHr1e2WaphfCusjmk27V_FAYTzw05HvW4SPCx55EeeTJYIwDfQwjLfP4aKV-I8HQCINt-2yxJvzH7Izy9AW-7rYU0Il_gW5hrhIS5MTM12GBXLVs2Ij1CCLXIs4cO0x6e8KEIKwIjf7iAu60JPmnb_fx4QgBlF2HLw9vXMwZokor8yktESoGl1nvf5VV5GHWSIKAur3KPS2Tb0ekNh-tIk9u-xob4d9eIf6tge_d3aq1LcAtrDBDLk8AD0bho5zrVuTmZ9k-lBVPr_DRHSV_dlpu088j3ThaBsuV1olHK3vLFRhYCDIO0CqqK5IuhqtRNnRaqhlNN6fQUHpXk2SwHiJ2W36RCYMTnno6ezFk_tN-RA2ly-FomNZoC5FPA9gFwoJR7ZmVFDmUeK3bW-zYTA5vu15lpBPnt7Up_5rZKkr0WQVbhWJmylqOuwuNWbn3SrMQ8rYFZ23Tv300cOfKVgRBaePWQb4"
+ }
+
+'confirm' in this case is the base64url encoded RSA signature of the concatenation of 'secret' with the base64url encoded whirlpool hash of the source guid and guid_sig; signed with the source channel private key. This prevents a man-in-the-middle from inserting a rogue success packet. Upon receipt and successful verification of this packet, the destination site will redirect to the original destination URL and indicate a successful remote login.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/doc/zot_structures.md b/sources/doc/zot_structures.md
new file mode 100644
index 00000000..e8a65ff1
--- /dev/null
+++ b/sources/doc/zot_structures.md
@@ -0,0 +1,62 @@
+Zot Structures
+==============
+
+**Zot signatures**
+All signed data in zot is accomplished by performing an RSA sign operation using the private key of the initiator. The binary result is then base64url encoded for transport.
+
+**Zot encryption**
+
+Encryption is currently provided by AES256CBC, though additional algorithms MAY be supported. A 32-octet key and 16-octet initialisation vector are randomly generated. The desired data is then encrypted using these generated strings and the result base64url encoded. Then we build an array:
+
+ data: the base64url encoded encrypted data
+ alg: The chosen algorithm, in this case the string 'aes256cbc'.
+ key: The randomly generated key, RSA encrypted using the recipients public key, and the result base64url encoded
+ iv: The randomly generated IV, RDSA encrypted using the recipient's public key, and the result base64url encoded
+
+
+
+**The zot basic packet**
+
+Used for initiating a dialogue with another zot site. This packet MAY be encrypted. The presence of an array element 'iv' indicates encryption has been applied. When sending an 'auth_check' packet type, this packet MUST be encrypted, using the public key of the destination site (the site key, as opposed to a sender key).
+
+
+ {
+ "type":"notify",
+ "sender":{
+ "guid":"kgVFf_1_SSbyqH-BNWjWuhAvJ2EhQBTUdw-Q1LwwssAntr8KTBgBSzNVzUm9_RwuDpxI6X8me_QQhZMf7RfjdA",
+ "guid_sig":"PT9-TApzpm7QtMxC63MjtdK2nUyxNI0tUoWlOYTFGke3kNdtxSzSvDV4uzq_7SSBtlrNnVMAFx2_1FDgyKawmqVtRPmT7QSXrKOL2oPzL8Hu_nnVVTs_0YOLQJJ0GYACOOK-R5874WuXLEept5-KYg0uShifsvhHnxnPIlDM9lWuZ1hSJTrk3NN9Ds6AKpyNRqf3DUdz81-Xvs8I2kj6y5vfFtm-FPKAqu77XP05r74vGaWbqb1r8zpWC7zxXakVVOHHC4plG6rLINjQzvdSFKCQb5R_xtGsPPfvuE24bv4fvN4ZG2ILvb6X4Dly37WW_HXBqBnUs24mngoTxFaPgNmz1nDQNYQu91-ekX4-BNaovjDx4tP379qIG3-NygHTjFoOMDVUvs-pOPi1kfaoMjmYF2mdZAmVYS2nNLWxbeUymkHXF8lT_iVsJSzyaRFJS1Iqn7zbvwH1iUBjD_pB9EmtNmnUraKrCU9eHES27xTwD-yaaH_GHNc1XwXNbhWJaPFAm35U8ki1Le4WbUVRluFx0qwVqlEF3ieGO84PMidrp51FPm83B_oGt80xpvf6P8Ht5WvVpytjMU8UG7-js8hAzWQeYiK05YTXk-78xg0AO6NoNe_RSRk05zYpF6KlA2yQ_My79rZBv9GFt4kUfIxNjd9OiV1wXdidO7Iaq_Q",
+ "url":"http:\/\/podunk.edu",
+ "url_sig":"T8Bp7j5DHHhQDCFcAHXfuhUfGk2P3inPbImwaXXF1xJd3TGgluoXyyKDx6WDm07x0hqbupoAoZB1qBP3_WfvWiJVAK4N1FD77EOYttUEHZ7L43xy5PCpojJQmkppGbPJc2jnTIc_F1vvGvw5fv8gBWZvPqTdb6LWF6FLrzwesZpi7j2rsioZ3wyUkqb5TDZaNNeWQrIEYXrEnWkRI_qTSOzx0dRTsGO6SpU1fPWuOOYMZG8Nh18nay0kLpxReuHCiCdxjXRVvk5k9rkcMbDBJcBovhiSioPKv_yJxcZVBATw3z3TTE95kGi4wxCEenxwhSpvouwa5b0hT7NS4Ay70QaxoKiLb3ZjhZaUUn4igCyZM0h6fllR5I6J_sAQxiMYD0v5ouIlb0u8YVMni93j3zlqMWdDUZ4WgTI7NNbo8ug9NQDHd92TPmSE1TytPTgya3tsFMzwyq0LZ0b-g-zSXWIES__jKQ7vAtIs9EwlPxqJXEDDniZ2AJ6biXRYgE2Kd6W_nmI7w31igwQTms3ecXe5ENI3ckEPUAq__llNnND7mxp5ZrdXzd5HHU9slXwDShYcW3yDeQLEwAVomTGSFpBrCX8W77n9hF3JClkWaeS4QcZ3xUtsSS81yLrp__ifFfQqx9_Be89WVyIOoF4oydr08EkZ8zwlAsbZLG7eLXY"
+ },
+ "callback":"\/post",
+ "version":1,
+ "secret":"1eaa6613699be6ebb2adcefa5379c61a3678aa0df89025470fac871431b70467",
+ "secret_sig":"0uShifsvhHnxnPIlDM9lWuZ1hSJTrk3NN9Ds6AKpyNRqf3DUdz81-Xvs8I2kj6y5vfFtm-FPKAqu77XP05r74vGaWbqb1r8zpWC7zxXakVVOHHC4plG6rLINjQzvdSFKCQb5R_xtGsPPfvuE24bv4fvN4ZG2ILvb6X4Dly37WW_HXBqBnUs24mngoTxFaPgNmz1nDQNYQu91-ekX4-BNaovjDx4tP379qIG3-NygHTjFoOMDVUvs-pOPi1kfaoMjmYF2mdZAmVYS2nNLWxbeUymkHXF8lT_iVsJSzyaRFJS1Iqn7zbvwH1iUBjD_pB9EmtNmnUraKrCU9eHES27xTwD-yaaH_GHNc1XwXNbhWJaPFAm35U8ki1Le4WbUVRluFx0qwVqlEF3ieGO84PMidrp51FPm83B_oGt80xpvf6P8Ht5WvVpytjMU8UG7-js8hAzWQeYiK05YTXk-78xg0AO6NoNe_RSRk05zYpF6KlA2yQ_My79rZBv9GFt4kUfIxNjd9OiV1wXdidO7Iaq_Q"
+ }
+
+
+Type: is the message type. One of 'notify', 'purge' refresh' 'force_refresh', 'auth_check', 'ping' or 'pickup'. The packet contents vary by message type. Here we will describe the 'notify' packet.
+
+Sender is an array of four components.
+
+The guid of the sender is typically a 64 character base64url encoded string. This is generated when an identity is created and an attempt is made that it be unique; though this isn't required.
+
+The guid_sig is the RSA signature of the guid, signed by the sender's private key.
+
+url is the base url of the location this post is originating from.
+
+url_sig is the RSA signature of url, signed by the sender's private key.
+
+
+These four elements provide a portable identity. We can contact the URL provided and download a zot info packet to obtain the public key of the sender, and use that to verify the sender guid and the posting URL signatures.
+
+
+callback is a string to be appended onto the url which identifies the zot communications endpoint on this system. It is typically the string "/post".
+
+version is the zot protocol identifier, to allow future protocol revisions to co-exist.
+
+secret is a 64-char string which is randomly generated by the sending site.
+
+secret_sig is the RSA signature of the secret, signed with the sender's private key.
+
+#include doc/macros/main_footer.bb;
diff --git a/sources/extend/addon/matrix/README.md b/sources/extend/addon/matrix/README.md
new file mode 100644
index 00000000..ffb55595
--- /dev/null
+++ b/sources/extend/addon/matrix/README.md
@@ -0,0 +1,6 @@
+hubzilla-addons
+================
+
+These are addons for hubzilla sites (see https://github.com/redmatrix/hubzilla )
+
+
diff --git a/sources/extend/addon/matrix/adultphotoflag/adultphotoflag.php b/sources/extend/addon/matrix/adultphotoflag/adultphotoflag.php
new file mode 100755
index 00000000..a8b1371a
--- /dev/null
+++ b/sources/extend/addon/matrix/adultphotoflag/adultphotoflag.php
@@ -0,0 +1,28 @@
+
+
+ */
+
+function adultphotoflag_load() {
+ register_hook('get_features','addon/adultphotoflag/adultphotoflag.php','adultphotoflag_get_features');
+}
+
+function adultphotoflag_unload() {
+ unregister_hook('get_features','addon/adultphotoflag/adultphotoflag.php','adultphotoflag_get_features');
+}
+
+function adultphotoflag_get_features(&$a,&$b) {
+
+ $b['tools'][] = array(
+ 'adult_photo_flagging',
+ t('Flag Adult Photos'),
+ t('Provide photo edit option to hide inappropriate photos from default album view'),false);
+
+}
+
diff --git a/sources/extend/addon/matrix/bbmath/README b/sources/extend/addon/matrix/bbmath/README
new file mode 100644
index 00000000..e2e9f62c
--- /dev/null
+++ b/sources/extend/addon/matrix/bbmath/README
@@ -0,0 +1,3 @@
+Adds a new tag, [tex] that can be used in bbcode. Note that you still also have to use $...$ to get equations correct, i.e. [tex] doesn't eneter math-mode by default.
+
+Requires images and tmp directory in your Red root directory (e.g. /var/www/red). Must be writable by server (e.g chown -R www-data tmp images). Also requires latex and imagemagick to be installed.
diff --git a/sources/extend/addon/matrix/bbmath/bbmath.php b/sources/extend/addon/matrix/bbmath/bbmath.php
new file mode 100644
index 00000000..118772dd
--- /dev/null
+++ b/sources/extend/addon/matrix/bbmath/bbmath.php
@@ -0,0 +1,22 @@
+
+ *
+ */
+
+require_once('phplatex.php');
+function bbmath_load() {
+ register_hook('bbcode','addon/bbmath/bbmath.php','bbmath_bbcode');
+
+}
+function bbmath_unload() {
+ unregister_hook('bbcode','addon/bbmath/bbmath.php','bbmath_bbcode');
+}
+
+function bbmath_bbcode($a,&$text) {
+ $text = preg_replace_callback('|\[tex\](.*?)\[/tex\]|',function($m) { return texify($m[1]); },$text);
+}
diff --git a/sources/extend/addon/matrix/bbmath/gpl.txt b/sources/extend/addon/matrix/bbmath/gpl.txt
new file mode 100644
index 00000000..d511905c
--- /dev/null
+++ b/sources/extend/addon/matrix/bbmath/gpl.txt
@@ -0,0 +1,339 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users. This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it. (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.) You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+ To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have. You must make sure that they, too, receive or can get the
+source code. And you must show them these terms so they know their
+rights.
+
+ We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+ Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software. If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+ Finally, any free program is threatened constantly by software
+patents. We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary. To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ GNU GENERAL PUBLIC LICENSE
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License. The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language. (Hereinafter, translation is included without limitation in
+the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+ 1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+ 2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) You must cause the modified files to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in
+ whole or in part contains or is derived from the Program or any
+ part thereof, to be licensed as a whole at no charge to all third
+ parties under the terms of this License.
+
+ c) If the modified program normally reads commands interactively
+ when run, you must cause it, when started running for such
+ interactive use in the most ordinary way, to print or display an
+ announcement including an appropriate copyright notice and a
+ notice that there is no warranty (or else, saying that you provide
+ a warranty) and that users may redistribute the program under
+ these conditions, and telling the user how to view a copy of this
+ License. (Exception: if the Program itself is interactive but
+ does not normally print such an announcement, your work based on
+ the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable
+ source code, which must be distributed under the terms of Sections
+ 1 and 2 above on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three
+ years, to give any third party, for a charge no more than your
+ cost of physically performing source distribution, a complete
+ machine-readable copy of the corresponding source code, to be
+ distributed under the terms of Sections 1 and 2 above on a medium
+ customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer
+ to distribute corresponding source code. (This alternative is
+ allowed only for noncommercial distribution and only if you
+ received the program in object code or executable form with such
+ an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it. For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable. However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License. Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+ 5. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Program or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+ 6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+ 7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all. For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded. In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+ 9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation. If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+ 10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission. For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this. Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+ NO WARRANTY
+
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ '.$totex.'
Log file:
'.$log.''.phplatex_cleantmp($tfn,$heredir); + } + + + #DVI -> PostScript. Since dvips uses lpr, which may be configured to actually print by default, force writing to a file with -o + exec($path_to_dvips.' '.$tfn.'.dvi -o '.$tfn.'.ps'); + if ( !file_exists($tfn.'.ps')) { + return '[dvi2ps error] '.phplatex_cleantmp($tfn,$heredir); + } + + + #PostScript -> image. Trim based on corner pixel, and set transparent color. + exec($path_to_convert.' -transparent-color "#'.$back.'" -colorspace RGB -density '.$dpi.' -trim +page '.$tfn.'.ps -transparent "#'.$back.'" '.$tfn.'.'.$imgfmt); + #Note: +page OR -page +0+0 OR +repage moves the image to the cropped area (kills offset) + #Older code tried: exec('/usr/bin/mogrify -density 90 -trim +page -format $imgfmt '.$tfn.'.ps'); + # It seems some versions of convert may not have -trim. Old versions? + + if (!file_exists($tfn.'.'.$imgfmt)) { + return '[image convert error] '.phplatex_cleantmp($tfn,$heredir); + } + + #Copy result image to chache. + copy($tfn.'.'.$imgfmt, $heredir.'/images/'.$strhash.'.'.$imgfmt); + + #Clean up temporary files, and return link to just-created image + return phplatex_cleantmp($tfn,$heredir).'
Calculator
++
+
|
Guitar Chords
'; +$o .= 'The complete online guitar chord dictionary'; +$args = ''; +$l = ''; + +if($_SERVER['REQUEST_METHOD'] == 'POST') { + if(isset($_POST['chord']) && strlen($_POST['chord'])) + $args .= escapeshellarg(ucfirst(trim($_POST['chord']))); + if((strlen($args)) && (isset($_POST['tuning'])) && (strlen($_POST['tuning']))) + $args .= ' '.escapeshellarg($_POST['tuning']); + if((strlen($args)) && (isset($_POST['lefty']))) + $args .= ' lefty'; +} + +if((! strlen($args)) && (! stristr(basename($_SERVER['QUERY_STRING']),'chords')) && strlen(basename($_SERVER['QUERY_STRING']))) + $args = escapeshellarg(ucfirst(basename($_SERVER['QUERY_STRING']))); + +$tunings = array("","openg", "opene", "dadgad"); +$tnames = array("Em11 [Standard] (EADGBE)", + "G/D [Drop D] (DGDGBD)","Open E (EBEG#BE)","Dsus4 (DADGAD)"); +$t = ((isset($_POST['tuning'])) ? $_POST['tuning'] : ''); +if(isset($_POST['lefty']) && $_POST['lefty'] == '1') + $l = 'checked="checked"'; + + $ch = ((isset($_POST['chord'])) ? $_POST['chord'] : ''); +$o .= <<< EOT + + +
+EOT; + +if(strlen($args)) { + $o .= '
';
+ $o .= shell_exec("addon/chords/chord ".$args);
+ $o .= '';
+}
+else {
+
+$o .= <<< EOT
+
++This is a fairly comprehensive and complete guitar chord dictionary which will list most of the available ways to play a certain chord, starting from the base of the fingerboard up to a few frets beyond the twelfth fret (beyond which everything repeats). A couple of non-standard tunings are provided for the benefit of slide players, etc. +
++Chord names start with a root note (A-G) and may include sharps (#) and flats (b). This software will parse most of the standard naming conventions such as maj, min, dim, sus(2 or 4), aug, with optional repeating elements. +
++Valid examples include A, A7, Am7, Amaj7, Amaj9, Ammaj7, Aadd4, Asus2Add4, E7b13b11 ... +
+Quick Reference:+ +EOT; + +$keys = array('A','Bb','B', 'C','Db','D','Eb','E','F','Gb','G','Ab'); +$o .= '
| $k | "; +$o .= "
| {$k}m | "; +$o .= "
| {$k}7 | "; +$o .= "
' . t('Diaspora Protocol Settings'), '', t('Submit')),
+ '$content' => $sc
+ ));
+
+ return;
+
+}
\ No newline at end of file
diff --git a/sources/extend/addon/matrix/diaspora/p.php b/sources/extend/addon/matrix/diaspora/p.php
new file mode 100644
index 00000000..3df8cd55
--- /dev/null
+++ b/sources/extend/addon/matrix/diaspora/p.php
@@ -0,0 +1,52 @@
+get_hostname();
+
+ $item = $r[0];
+
+ $title = $item['title'];
+ $body = bb2diaspora_itembody($item);
+ $created = datetime_convert('UTC','UTC',$item['created'],'Y-m-d H:i:s \U\T\C');
+
+ $tpl = get_markup_template('diaspora_post.tpl');
+ $msg = replace_macros($tpl, array(
+ '$body' => xmlify($body),
+ '$guid' => $item['mid'],
+ '$handle' => xmlify($myaddr),
+ '$public' => 'true',
+ '$created' => $created,
+ '$provider' => (($item['app']) ? $item['app'] : t('$projectname'))
+ ));
+
+ header('Content-type: text/xml');
+ echo $msg;
+ killme();
+}
\ No newline at end of file
diff --git a/sources/extend/addon/matrix/diaspora/receive.php b/sources/extend/addon/matrix/diaspora/receive.php
new file mode 100644
index 00000000..0c73a57c
--- /dev/null
+++ b/sources/extend/addon/matrix/diaspora/receive.php
@@ -0,0 +1,69 @@
+token_regex = '/content="(.*?)" name="csrf-token/';
+
+ $this->pod = $pod;
+ $this->cookiejar = tempnam(sys_get_temp_dir(), 'cookies');
+ }
+
+ function _fetch_token() {
+ $ch = curl_init();
+
+ curl_setopt ($ch, CURLOPT_URL, $this->pod . "/stream");
+ curl_setopt ($ch, CURLOPT_COOKIEFILE, $this->cookiejar);
+ curl_setopt ($ch, CURLOPT_COOKIEJAR, $this->cookiejar);
+ curl_setopt ($ch, CURLOPT_FOLLOWLOCATION, true);
+ curl_setopt ($ch, CURLOPT_RETURNTRANSFER, true);
+
+ $output = curl_exec ($ch);
+ curl_close($ch);
+
+ // Token holen und zurückgeben
+ preg_match($this->token_regex, $output, $matches);
+ return $matches[1];
+ }
+
+ function login($username, $password) {
+ $datatopost = array(
+ 'user[username]' => $username,
+ 'user[password]' => $password,
+ 'authenticity_token' => $this->_fetch_token()
+ );
+
+ $poststr = http_build_query($datatopost);
+
+ // Adresse per cURL abrufen
+ $ch = curl_init();
+
+ curl_setopt ($ch, CURLOPT_URL, $this->pod . "/users/sign_in");
+ curl_setopt ($ch, CURLOPT_COOKIEFILE, $this->cookiejar);
+ curl_setopt ($ch, CURLOPT_COOKIEJAR, $this->cookiejar);
+ curl_setopt ($ch, CURLOPT_FOLLOWLOCATION, false);
+ curl_setopt ($ch, CURLOPT_RETURNTRANSFER, true);
+ curl_setopt ($ch, CURLOPT_POST, true);
+ curl_setopt ($ch, CURLOPT_POSTFIELDS, $poststr);
+
+ curl_exec ($ch);
+ $info = curl_getinfo($ch);
+ curl_close($ch);
+
+ if($info['http_code'] != 302) {
+ throw new Exception('Login error '.print_r($info, true));
+ }
+
+ // Das Objekt zurückgeben, damit man Aurufe verketten kann.
+ return $this;
+ }
+
+ function post($text, $provider = "diasphp") {
+ // post-daten vorbereiten
+ $datatopost = json_encode(array(
+ 'aspect_ids' => 'public',
+ 'status_message' => array('text' => $text,
+ 'provider_display_name' => $provider)
+ ));
+
+ // header vorbereiten
+ $headers = array(
+ 'Content-Type: application/json',
+ 'accept: application/json',
+ 'x-csrf-token: '.$this->_fetch_token()
+ );
+
+ // Adresse per cURL abrufen
+ $ch = curl_init();
+
+ curl_setopt ($ch, CURLOPT_URL, $this->pod . "/status_messages");
+ curl_setopt ($ch, CURLOPT_COOKIEFILE, $this->cookiejar);
+ curl_setopt ($ch, CURLOPT_COOKIEJAR, $this->cookiejar);
+ curl_setopt ($ch, CURLOPT_FOLLOWLOCATION, false);
+ curl_setopt ($ch, CURLOPT_RETURNTRANSFER, true);
+ curl_setopt ($ch, CURLOPT_POST, true);
+ curl_setopt ($ch, CURLOPT_POSTFIELDS, $datatopost);
+ curl_setopt ($ch, CURLOPT_HTTPHEADER, $headers);
+
+ curl_exec ($ch);
+ $info = curl_getinfo($ch);
+ curl_close($ch);
+
+ if($info['http_code'] != 201) {
+ throw new Exception('Post error '.print_r($info, true));
+ }
+
+ // Ende der möglichen Kette, gib mal "true" zurück.
+ return true;
+ }
+}
+?>
diff --git a/sources/extend/addon/matrix/diaspost/diaspora.png b/sources/extend/addon/matrix/diaspost/diaspora.png
new file mode 100644
index 00000000..96665916
Binary files /dev/null and b/sources/extend/addon/matrix/diaspost/diaspora.png differ
diff --git a/sources/extend/addon/matrix/diaspost/diaspost.css b/sources/extend/addon/matrix/diaspost/diaspost.css
new file mode 100755
index 00000000..e69de29b
diff --git a/sources/extend/addon/matrix/diaspost/diaspost.php b/sources/extend/addon/matrix/diaspost/diaspost.php
new file mode 100755
index 00000000..b4200fc8
--- /dev/null
+++ b/sources/extend/addon/matrix/diaspost/diaspost.php
@@ -0,0 +1,337 @@
+
+ */
+
+function diaspost_load() {
+ register_hook('post_local', 'addon/diaspost/diaspost.php', 'diaspost_post_local');
+ register_hook('notifier_normal', 'addon/diaspost/diaspost.php', 'diaspost_send');
+ register_hook('jot_networks', 'addon/diaspost/diaspost.php', 'diaspost_jot_nets');
+ register_hook('feature_settings', 'addon/diaspost/diaspost.php', 'diaspost_settings');
+ register_hook('feature_settings_post', 'addon/diaspost/diaspost.php', 'diaspost_settings_post');
+
+}
+function diaspost_unload() {
+ unregister_hook('post_local', 'addon/diaspost/diaspost.php', 'diaspost_post_local');
+ unregister_hook('notifier_normal', 'addon/diaspost/diaspost.php', 'diaspost_send');
+ unregister_hook('jot_networks', 'addon/diaspost/diaspost.php', 'diaspost_jot_nets');
+ unregister_hook('feature_settings', 'addon/diaspost/diaspost.php', 'diaspost_settings');
+ unregister_hook('feature_settings_post', 'addon/diaspost/diaspost.php', 'diaspost_settings_post');
+
+}
+
+
+function diaspost_jot_nets(&$a,&$b) {
+ if((! local_channel()) || (! perm_is_allowed(local_channel(),'','view_stream')))
+ return;
+
+ $diaspost_post = get_pconfig(local_channel(),'diaspost','post');
+ if(intval($diaspost_post) == 1) {
+ $diaspost_defpost = get_pconfig(local_channel(),'diaspost','post_by_default');
+ $selected = ((intval($diaspost_defpost) == 1) ? ' checked="checked" ' : '');
+ $b .= ' ' . t('Post to Diaspora') . '';
+ $sc .= '' . $status . '';
+ $sc .= '
';
+ }
+
+ $sc .= replace_macros(get_markup_template('field_checkbox.tpl'), array(
+ '$field' => array('diaspost', t('Enable Diaspost Post Plugin'), $checked, '', array(t('No'),t('Yes'))),
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_input.tpl'), array(
+ '$field' => array('diaspost_username', t('Diaspora username'), $diaspost_username, '')
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_password.tpl'), array(
+ '$field' => array('diaspost_password', t('Diaspora password'), $diaspost_password, '')
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_input.tpl'), array(
+ '$field' => array('diaspost_url', t('Diaspora site URL'), $diaspost_url, 'Example: https://joindiaspora.com')
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_checkbox.tpl'), array(
+ '$field' => array('diaspost_bydefault', t('Post to Diaspora by default'), $def_checked, '', array(t('No'),t('Yes'))),
+ ));
+
+ $s .= replace_macros(get_markup_template('generic_addon_settings.tpl'), array(
+ '$addon' => array('diaspost', '' . t('Diaspost Post Settings'), '', t('Submit')),
+ '$content' => $sc
+ ));
+
+ return;
+}
+
+
+function diaspost_settings_post(&$a,&$b) {
+
+ if(x($_POST,'diaspost-submit')) {
+
+ set_pconfig(local_channel(),'diaspost','post',intval($_POST['diaspost']));
+ set_pconfig(local_channel(),'diaspost','post_by_default',intval($_POST['diaspost_bydefault']));
+ set_pconfig(local_channel(),'diaspost','diaspost_username',trim($_POST['diaspost_username']));
+ set_pconfig(local_channel(),'diaspost','diaspost_password',z_obscure(trim($_POST['diaspost_password'])));
+ set_pconfig(local_channel(),'diaspost','diaspost_url',trim($_POST['diaspost_url']));
+
+ }
+
+}
+
+function diaspost_post_local(&$a,&$b) {
+
+ if($b['created'] != $b['edited'])
+ return;
+
+ if(! perm_is_allowed($b['uid'],'','view_stream'))
+ return;
+
+
+ if((! local_channel()) || (local_channel() != $b['uid']))
+ return;
+
+ if($b['item_private'])
+ return;
+
+ $diaspost_post = intval(get_pconfig(local_channel(),'diaspost','post'));
+
+ $diaspost_enable = (($diaspost_post && x($_REQUEST,'diaspost_enable')) ? intval($_REQUEST['diaspost_enable']) : 0);
+
+ if($_REQUEST['api_source'] && intval(get_pconfig(local_channel(),'diaspost','post_by_default')))
+ $diaspost_enable = 1;
+
+ if(! $diaspost_enable)
+ return;
+
+ if(strlen($b['postopts']))
+ $b['postopts'] .= ',';
+ $b['postopts'] .= 'diaspost';
+}
+
+
+
+
+function diaspost_send(&$a,&$b) {
+ $hostname = 'hubzilla ' . '(' . $a->get_hostname() . ')';
+
+ logger('diaspost_send: invoked',LOGGER_DEBUG);
+
+ if($b['mid'] != $b['parent_mid'])
+ return;
+
+ if((! is_item_normal($b)) || $b['item_private'] || ($b['created'] !== $b['edited']))
+ return;
+
+
+ if(! perm_is_allowed($b['uid'],'','view_stream'))
+ return;
+
+
+ if(! strstr($b['postopts'],'diaspost'))
+ return;
+
+
+ logger('diaspost_send: prepare posting', LOGGER_DEBUG);
+
+ $diaspost_username = get_pconfig($b['uid'],'diaspost','diaspost_username');
+ $diaspost_password = z_unobscure(get_pconfig($b['uid'],'diaspost','diaspost_password'));
+ $diaspost_url = get_pconfig($b['uid'],'diaspost','diaspost_url');
+
+ if($diaspost_url && $diaspost_username && $diaspost_password) {
+
+ logger('diaspost_send: all values seem to be okay', LOGGER_DEBUG);
+
+ require_once('include/bb2diaspora.php');
+ $tag_arr = array();
+ $tags = '';
+ $x = preg_match_all('/\#\[(.*?)\](.*?)\[/',$b['tag'],$matches,PREG_SET_ORDER);
+
+ if($x) {
+ foreach($matches as $mtch) {
+ $tag_arr[] = $mtch[2];
+ }
+ }
+ if(count($tag_arr))
+ $tags = implode(',',$tag_arr);
+
+ $title = $b['title'];
+ $body = $b['body'];
+ // Insert a newline before and after a quote
+ $body = str_ireplace("[quote", "\n\n[quote", $body);
+ $body = str_ireplace("[/quote]", "[/quote]\n\n", $body);
+
+ // strip bookmark indicators
+
+ $body = preg_replace('/\#\^\[([zu])rl/i', '[$1rl', $body);
+
+ $body = preg_replace('/\#\^http/i', 'http', $body);
+
+
+ if(intval(get_pconfig($item['uid'],'system','prevent_tag_hijacking'))) {
+ $new_tag = html_entity_decode('⋕',ENT_COMPAT,'UTF-8');
+ $new_mention = html_entity_decode('＠',ENT_COMPAT,'UTF-8');
+
+ // #-tags
+ $body = preg_replace('/\#\[url/i', $new_tag . '[url', $body);
+ $body = preg_replace('/\#\[zrl/i', $new_tag . '[zrl', $body);
+ // @-mentions
+ $body = preg_replace('/\@\!?\[url/i', $new_mention . '[url', $body);
+ $body = preg_replace('/\@\!?\[zrl/i', $new_mention . '[zrl', $body);
+ }
+
+ // remove multiple newlines
+ do {
+ $oldbody = $body;
+ $body = str_replace("\n\n\n", "\n\n", $body);
+ } while ($oldbody != $body);
+
+ // convert to markdown
+ $body = bb2diaspora($body, false, true);
+
+ // Adding the title
+ if(strlen($title))
+ $body = "## ".html_entity_decode($title)."\n\n".$body;
+
+ require_once("addon/diaspost/diasphp.php");
+
+ try {
+ logger('diaspost_send: prepare', LOGGER_DEBUG);
+ $conn = new Diasphp($diaspost_url);
+ logger('diaspost_send: try to log in '.$diaspost_username, LOGGER_DEBUG);
+ $conn->login($diaspost_username, $diaspost_password);
+ logger('diaspost_send: try to send '.$body, LOGGER_DEBUG);
+
+ //throw new Exception('Test');
+ $conn->post($body, $hostname);
+
+ logger('diaspost_send: success');
+ } catch (Exception $e) {
+ logger("diaspost_send: Error submitting the post: " . $e->getMessage());
+
+// logger('diaspost_send: requeueing '.$b['uid'], LOGGER_DEBUG);
+
+// $r = q("SELECT `id` FROM `contact` WHERE `uid` = %d AND `self`", $b['uid']);
+// if (count($r))
+// $a->contact = $r[0]["id"];
+
+// $s = serialize(array('url' => $url, 'item' => $b['id'], 'post' => $body));
+// require_once('include/queue_fn.php');
+// add_to_queue($a->contact,NETWORK_DIASPORA2,$s);
+// notice(t('Diaspost post failed. Queued for retry.').EOL);
+ }
+ }
+}
diff --git a/sources/extend/addon/matrix/dirstats/dirstats.php b/sources/extend/addon/matrix/dirstats/dirstats.php
new file mode 100644
index 00000000..21780eef
--- /dev/null
+++ b/sources/extend/addon/matrix/dirstats/dirstats.php
@@ -0,0 +1,204 @@
+
+*/
+
+function dirstats_load() {
+ register_hook('cron_daily', 'addon/dirstats/dirstats.php', 'dirstats_cron');
+}
+function dirstats_unload() {
+ unregister_hook('cron_daily', 'addon/dirstats/dirstats.php', 'dirstats_cron');
+}
+function dirstats_module() {}
+
+
+function dirstats_init() {
+ if(! get_config('dirstats','hubcount'))
+ dirstats_cron($a,$b);
+
+}
+
+function dirstats_content(&$a) {
+
+ $hubcount = get_config('dirstats','hubcount');
+ $zotcount = get_config('dirstats','zotcount');
+ $friendicacount = get_config('dirstats','friendicacount');
+ $diasporacount = get_config('dirstats','diasporacount');
+ $channelcount = get_config('dirstats','channelcount');
+ $friendicachannelcount = get_config('dirstats','friendicachannelcount');
+ $diasporachannelcount = get_config('dirstats','diasporachannelcount');
+ $over35s = get_config('dirstats','over35s');
+ $under35s = get_config('dirstats','under35s');
+ $average = get_config('dirstats','averageage');
+ $chatrooms = get_config('dirstats','chatrooms');
+ $tags = get_config('dirstats','tags');
+
+ $ob = $a->get_observer();
+ $observer = $ob['xchan_hash'];
+ // Requested by Martin
+ $fountainofyouth = get_xconfig($observer, 'dirstats', 'averageage');
+ if (intval($fountainofyouth))
+ $average = $fountainofyouth;
+
+if (argv(1) == 'json') {
+ $dirstats = array (
+ 'hubcount' => $hubcount,
+ 'zotcount' => $zotcount,
+ 'friendicacount' => $friendicacount,
+ 'diasporacount' => $diasporacount,
+ 'channelcount' => $channelcount,
+ 'friendicachannelcount' => $friendicachannelcount,
+ 'diasporachannelcount' => $diasporachannelcount,
+ 'over35s' => $over35s,
+ 'under35s' => $under35s,
+ 'average' => $average,
+ 'chatrooms' => $chatrooms,
+ 'tags' => $tags
+ );
+ echo json_return_and_die($dirstats);
+ }
+
+ // Used by Hubzilla News
+ elseif (argv(1) == 'genpost' && get_config('dirstats','allowfiledump')) {
+ $result = '[b]Hub count[/b] : ' . $hubcount . "\xA" .
+ '[b]Hubzilla Hubs[/b] : ' . $zotcount . "\xA" .
+ '[b]Friendica Hubs[/b] : ' . $friendicacount . "\xA" .
+ '[b]Diaspora Pods[/b] : ' . $diasporacount . "\xA" .
+ '[b]Hubzilla Channels[/b] : ' . $channelcount . "\xA" .
+ '[b]Friendica Profiles[/b] : ' . $friendicachannelcount . "\xA" .
+ '[b]Diaspora Profiles[/b] : ' . $diasporachannelcount . "\xA" .
+ '[b]People aged 35 and above[/b] : ' . $over35s . "\xA" .
+ '[b]People aged 34 and below[/b] : ' . $under35s . "\xA" .
+ '[b]Average Age[/b] : ' . $average . "\xA" .
+ '[b]Known Chatrooms[/b] : ' . $chatrooms . "\xA" .
+ '[b]Unique Profile Tags[/b] : ' . $tags . "\xA";
+
+ file_put_contents('genpost', $result);
+ }
+else {
+ $tpl = get_markup_template( "dirstats.tpl", "addon/dirstats/" );
+ return replace_macros($tpl, array(
+ '$title' => t('Hubzilla Directory Stats'),
+ '$hubtitle' => t('Total Hubs'),
+ '$hubcount' => $hubcount,
+ '$zotlabel' => t('Hubzilla Hubs'),
+ '$zotcount' => $zotcount,
+ '$friendicalabel' => t('Friendica Hubs'),
+ '$friendicacount' => $friendicacount,
+ '$diasporalabel' => t('Diaspora Pods'),
+ '$diasporacount' => $diasporacount,
+ '$zotchanlabel' => t('Hubzilla Channels'),
+ '$channelcount' => $channelcount,
+ '$friendicachanlabel' => t('Friendica Channels'),
+ '$friendicachannelcount' => $friendicachannelcount,
+ '$diasporachanlabel' => t('Diaspora Channels'),
+ '$diasporachannelcount' => $diasporachannelcount,
+ '$over35label' => t('Aged 35 and above'),
+ '$over35s' => $over35s,
+ '$under35label' => t('Aged 34 and under'),
+ '$under35s' => $under35s,
+ '$averageagelabel' => t('Average Age'),
+ '$average' => $average,
+ '$chatlabel' => t('Known Chatrooms'),
+ '$chatrooms' => $chatrooms,
+ '$tagslabel' => t('Known Tags'),
+ '$tags' => $tags,
+ '$disclaimer' => t('Please note Diaspora and Friendica statistics are merely those **this directory** is aware of, and not all those known in the network. This also applies to chatrooms,')
+ ));
+ }
+}
+function dirstats_cron(&$a, $b) {
+ // Some hublocs are immortal and won't ever die - they all have null date for hubloc_connected and hubloc_updated
+ $r = q("SELECT count(distinct hubloc_host) as total FROM `hubloc` where not (hubloc_flags & %d) > 0 and not (hubloc_connected = %d and hubloc_updated = %d)",
+ intval(HUBLOC_FLAGS_DELETED),
+ dbesc(NULL_DATE),
+ dbesc(NULL_DATE)
+ );
+ if ($r) {
+ $hubcount = $r[0]['total'];
+ set_config('dirstats','hubcount',$hubcount);
+ }
+
+ $r = q("SELECT count(distinct hubloc_host) as total FROM `hubloc` where hubloc_network = 'zot' and not (hubloc_flags & %d) > 0 and not (hubloc_connected = %d and hubloc_updated = %d)",
+ intval(HUBLOC_FLAGS_DELETED),
+ dbesc(NULL_DATE),
+ dbesc(NULL_DATE)
+
+ );
+ if ($r) {
+ $zotcount = $r[0]['total'];
+ set_config('dirstats','zotcount',$zotcount);
+ }
+ $r = q("SELECT count(distinct hubloc_host) as total FROM `hubloc` where hubloc_network = 'friendica-over-diaspora'");
+ if ($r){
+ $friendicacount = $r[0]['total'];
+ set_config('dirstats','friendicacount',$friendicacount);
+ }
+ $r = q("SELECT count(distinct hubloc_host) as total FROM `hubloc` where hubloc_network = 'diaspora'");
+ if ($r) {
+ $diasporacount = $r[0]['total'];
+ set_config('dirstats','diasporacount',$diasporacount);
+ }
+ $r = q("SELECT count(distinct xchan_hash) as total FROM `xchan` where xchan_network = 'zot' and not (xchan_flags & %d) > 0",
+ intval(XCHAN_FLAGS_DELETED)
+ );
+ if ($r) {
+ $channelcount = $r[0]['total'];
+ set_config('dirstats','channelcount',$channelcount);
+ }
+ $r = q("SELECT count(distinct xchan_hash) as total FROM `xchan` where xchan_network = 'friendica-over-diaspora'");
+ if ($r) {
+ $friendicachannelcount = $r[0]['total'];
+ set_config('dirstats','friendicachannelcount',$friendicachannelcount);
+ }
+ $r = q("SELECT count(distinct xchan_hash) as total FROM `xchan` where xchan_network = 'diaspora'");
+ if ($r) {
+ $diasporachannelcount = $r[0]['total'];
+ set_config('dirstats','diasporachannelcount',$diasporachannelcount);
+ }
+ $r = q("select count(xprof_hash) as total from `xprof` where xprof_age >=35");
+ if ($r) {
+ $over35s = $r[0]['total'];
+ set_config('dirstats','over35s',$over35s);
+ }
+ $r = q("select count(xprof_hash) as total from `xprof` where xprof_age <=34 and xprof_age >=1");
+ if ($r) {
+ $under35s = $r[0]['total'];
+ set_config('dirstats','under35s',$under35s);
+ }
+
+ $r = q("select sum(xprof_age) as sum from xprof");
+ if ($r) {
+ $rr = q("select count(xprof_hash) as total from `xprof` where xprof_age >=1");
+ $total = $r[0]['sum'];
+ $number = $rr[0]['total'];
+ if($number)
+ $average = $total / $number;
+ else
+ $average = 0;
+ set_config('dirstats','averageage',$average);
+ }
+
+ $r = q("select count(distinct xchat_url) as total from `xchat`");
+ if ($r) {
+ $chatrooms = $r[0]['total'];
+ set_config('dirstats','chatrooms',$chatrooms);
+ }
+ $r = q("select count(distinct xtag_term) as total from `xtag`");
+ if ($r) {
+ $tags = $r[0]['total'];
+ set_config('dirstats','tags',$tags);
+ }
+}
diff --git a/sources/extend/addon/matrix/dirstats/view/tpl/dirstats.tpl b/sources/extend/addon/matrix/dirstats/view/tpl/dirstats.tpl
new file mode 100644
index 00000000..f1c3a132
--- /dev/null
+++ b/sources/extend/addon/matrix/dirstats/view/tpl/dirstats.tpl
@@ -0,0 +1,20 @@
+
+
diff --git a/sources/extend/addon/matrix/donate/donate.apd b/sources/extend/addon/matrix/donate/donate.apd
new file mode 100644
index 00000000..eff602d3
--- /dev/null
+++ b/sources/extend/addon/matrix/donate/donate.apd
@@ -0,0 +1,3 @@
+url: $baseurl/donate
+name: Support Hubzilla
+photo: $baseurl/addon/donate/donate.png
diff --git a/sources/extend/addon/matrix/donate/donate.php b/sources/extend/addon/matrix/donate/donate.php
new file mode 100644
index 00000000..1eb6d57d
--- /dev/null
+++ b/sources/extend/addon/matrix/donate/donate.php
@@ -0,0 +1,75 @@
+' . t('The Redmatrix/Hubzilla projects are provided primarily by volunteers giving their time and expertise - and often paying out of pocket for services they share with others.') . '';
+$text .= '{{$title}}
+- {{$hubtitle}} : {{$hubcount}}
- {{$zotlabel}} : {{$zotcount}}
- {{$friendicalabel}} : {{$friendicacount}}
- {{$diasporalabel}} : {{$diasporacount}}
- {{$zotchanlabel}} : {{$channelcount}}
- {{$friendicachanlabel}} : {{$friendicachannelcount}}
- {{$diasporachanlabel}} : {{$diasporachannelcount}}
- {{$over35label}} : {{$over35s}}
- {{$under35label}} : {{$under35s}}
- {{$averageagelabel}} : {{$average}}
- {{$chatlabel}} : {{$chatrooms}}
- {{$tagslabel}} : {{$tags}}
{{$disclaimer}}
+' . t('There is no corporate funding and no ads, and we do not collect and sell your personal information. (We don\'t control your personal information - you do.)') . '
'; +$text .= '' . t('Help support our ground-breaking work in decentralisation, web identity, and privacy.') . '
'; + +$text .= '' . t('Your donations keep servers and services running and also helps us to provide innovative new features and continued development.') . '
'; + +$o = replace_macros(get_markup_template('donate.tpl','addon/donate'),array( + '$header' => t('Donate'), + '$text' => $text, + '$choice' => t('Choose a project, developer, or public hub to support with a one-time donation'), + '$onetime' => t('Donate Now'), + '$repeat' => t('Or become a project sponsor (Hubzilla Project only)'), + '$note' => t('Please indicate if you would like your first name or full name (or nothing) to appear in our sponsor listing'), + '$subscribe' => t('Sponsor'), + '$contributors' => $contributors, + '$sponsors' => $sponsors, + '$thanks' => t('Special thanks to: '), +)); + +call_hooks('donate_plugin',$o); + +return $o; + +} diff --git a/sources/extend/addon/matrix/donate/donate.png b/sources/extend/addon/matrix/donate/donate.png new file mode 100644 index 00000000..d932f001 Binary files /dev/null and b/sources/extend/addon/matrix/donate/donate.png differ diff --git a/sources/extend/addon/matrix/donate/tipping.jpg b/sources/extend/addon/matrix/donate/tipping.jpg new file mode 100644 index 00000000..f370ece7 Binary files /dev/null and b/sources/extend/addon/matrix/donate/tipping.jpg differ diff --git a/sources/extend/addon/matrix/donate/view/tpl/donate.tpl b/sources/extend/addon/matrix/donate/view/tpl/donate.tpl new file mode 100644 index 00000000..6382cc6f --- /dev/null +++ b/sources/extend/addon/matrix/donate/view/tpl/donate.tpl @@ -0,0 +1,64 @@ +{{$header}}
+ +{{$text}}
+
++ +
+
++
+ + + +
+ +
+{{$repeat}} +
++{{$note}} +
+ + + ++{{$thanks}} +
-
+{{foreach $sponsors as $s}}
+
- {{$s}} +{{/foreach}} +
'
+ . t('Post to Dreamwidth') . '
';
+ }
+}
+
+
+function dwpost_settings(&$a,&$s) {
+
+ if(! local_channel())
+ return;
+
+ /* Add our stylesheet to the page so we can make our settings look nice */
+
+ //$a->page['htmlhead'] .= '' . "\r\n";
+
+ /* Get the current state of our config variables */
+
+ $enabled = get_pconfig(local_channel(),'dwpost','post');
+
+ $checked = (($enabled) ? 1 : false);
+
+ $def_enabled = get_pconfig(local_channel(),'dwpost','post_by_default');
+
+ $def_checked = (($def_enabled) ? 1 : false);
+
+ $dw_username = get_pconfig(local_channel(), 'dwpost', 'dw_username');
+ $dw_password = z_unobscure(get_pconfig(local_channel(), 'dwpost', 'dw_password'));
+
+
+ /* Add some HTML to the existing form */
+
+ $sc .= replace_macros(get_markup_template('field_checkbox.tpl'), array(
+ '$field' => array('dwpost', t('Enable Dreamwidth Post Plugin'), $checked, '', array(t('No'),t('Yes'))),
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_input.tpl'), array(
+ '$field' => array('dw_username', t('Dreamwidth username'), $dw_username, '')
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_password.tpl'), array(
+ '$field' => array('dw_password', t('Dreamwidth password'), $dw_password, '')
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_checkbox.tpl'), array(
+ '$field' => array('dw_bydefault', t('Post to Dreamwidth by default'), $def_checked, '', array(t('No'),t('Yes'))),
+ ));
+
+ $s .= replace_macros(get_markup_template('generic_addon_settings.tpl'), array(
+ '$addon' => array('dwpost',t('Dreamwidth Post Settings'), '', t('Submit')),
+ '$content' => $sc
+ ));
+
+}
+
+
+function dwpost_settings_post(&$a,&$b) {
+
+ if(x($_POST,'dwpost-submit')) {
+
+ set_pconfig(local_channel(),'dwpost','post',intval($_POST['dwpost']));
+ set_pconfig(local_channel(),'dwpost','post_by_default',intval($_POST['dw_bydefault']));
+ set_pconfig(local_channel(),'dwpost','dw_username',trim($_POST['dw_username']));
+ set_pconfig(local_channel(),'dwpost','dw_password',z_obscure(trim($_POST['dw_password'])));
+
+ }
+
+}
+
+function dwpost_post_local(&$a,&$b) {
+
+ // This can probably be changed to allow editing by pointing to a different API endpoint
+
+ if($b['edit'])
+ return;
+
+ if((! local_channel()) || (local_channel() != $b['uid']))
+ return;
+
+ if($b['item_private'] || $b['parent'])
+ return;
+
+ logger('Dreamwidth xpost invoked');
+
+ $dw_post = intval(get_pconfig(local_channel(),'dwpost','post'));
+
+ $dw_enable = (($dw_post && x($_REQUEST,'dwpost_enable')) ? intval($_REQUEST['dwpost_enable']) : 0);
+
+ if($_REQUEST['api_source'] && intval(get_pconfig(local_channel(),'dwpost','post_by_default')))
+ $dw_enable = 1;
+
+ if(! $dw_enable)
+ return;
+
+ if(strlen($b['postopts']))
+ $b['postopts'] .= ',';
+ $b['postopts'] .= 'dwpost';
+}
+
+
+
+
+function dwpost_send(&$a,&$b) {
+
+ if((! is_item_normal($b)) || $b['item_private'] || ($b['created'] !== $b['edited']))
+ return;
+
+ if(! perm_is_allowed($b['uid'],'','view_stream'))
+ return;
+
+ if(! strstr($b['postopts'],'dwpost'))
+ return;
+
+ if($b['parent'] != $b['id'])
+ return;
+
+ // dreamwidth post in the LJ user's timezone.
+ // Hopefully the person's Friendica account
+ // will be set to the same thing.
+
+ $tz = 'UTC';
+
+ $x = q("select channel_timezone from channel where channel_id = %d limit 1",
+ intval($b['uid'])
+ );
+ if($x && strlen($x[0]['channel_timezone']))
+ $tz = $x[0]['channel_timezone'];
+
+ $dw_username = get_pconfig($b['uid'],'dwpost','dw_username');
+ $dw_password = z_unobscure(get_pconfig($b['uid'],'dwpost','dw_password'));
+ $dw_blog = 'http://www.dreamwidth.org/interface/xmlrpc';
+
+ if($dw_username && $dw_password && $dw_blog) {
+
+ require_once('include/bbcode.php');
+ require_once('include/datetime.php');
+
+ $title = $b['title'];
+ $post = bbcode($b['body']);
+ $post = xmlify($post);
+ $tags = dwpost_get_tags($b['tag']);
+
+ $date = datetime_convert('UTC',$tz,$b['created'],'Y-m-d H:i:s');
+ $year = intval(substr($date,0,4));
+ $mon = intval(substr($date,5,2));
+ $day = intval(substr($date,8,2));
+ $hour = intval(substr($date,11,2));
+ $min = intval(substr($date,14,2));
+
+ $xml = <<< EOT
+
+'.$code.'
';
+ // place the widget into the selected aside area
+ if ($lr=='right_aside') {
+ $b['layout']['region_right_aside'] = $flattrwidget . $b['layout']['region_right_aside'];
+ } else {
+ $b['layout']['region_aside'] = $flattrwidget . $b['layout']['region_aside'];
+ }
+}
+function flattrwidget_settings_post($a,$s) {
+ if(! local_channel() || (! x($_POST,'flattrwidget-submit')))
+ return;
+ $c = $a->get_channel();
+ set_pconfig( local_channel(), 'flattrwidget', 'align', $_POST['flattrwidget-align'] );
+ set_pconfig( local_channel(), 'flattrwidget', 'sd', $_POST['flattrwidget-static'] );
+ $thing = $_POST['flattrwidget-thing'];
+ if ($thing == '') {
+ $thing = $a->get_baseurl().'/channel/'.$c['channel_address'];
+ }
+ set_pconfig( local_channel(), 'flattrwidget', 'thing', $thing);
+ set_pconfig( local_channel(), 'flattrwidget', 'user', $_POST['flattrwidget-user']);
+ $ftitle = $_POST['flattrwidget-thingtitle'];
+ if ($ftitle == '') {
+ $ftitle = $c['channel_name'].' on The Hubzilla';
+ }
+ set_pconfig( local_channel(), 'flattrwidget', 'title', $ftitle);
+ set_pconfig( local_channel(), 'flattrwidget', 'enable', intval($_POST['flattrwidget-enable']));
+ info(t('Flattr widget settings updated.').EOL);
+}
+function flattrwidget_settings(&$a,&$s) {
+ $id = local_channel();
+ if (! $id)
+ return;
+
+ //$a->page['htmlhead'] .= '';
+ $lr = get_pconfig( $id, 'flattrwidget', 'align');
+ $sd = get_pconfig( $id, 'flattrwidget', 'sd');
+ $thing = get_pconfig( $id, 'flattrwidget', 'thing');
+ $user = get_pconfig( $id, 'flattrwidget', 'user');
+ $ftitle = get_pconfig( $id, 'flattrwidget', 'title');
+ $enable = intval(get_pconfig(local_channel(),'flattrwidget','enable'));
+ $enable_checked = (($enable) ? 1 : false);
+
+ $sc .= replace_macros(get_markup_template('field_input.tpl'), array(
+ '$field' => array('flattrwidget-user', t('Flattr user'), $user, '')
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_input.tpl'), array(
+ '$field' => array('flattrwidget-thing', t('URL of the Thing to flattr'), $thing, t('If empty channel URL is used'))
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_input.tpl'), array(
+ '$field' => array('flattrwidget-thingtitle', t('Title of the Thing to flattr'), $ftitle, t('If empty "channel name on The Hubzilla" will be used'))
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_select.tpl'), array(
+ '$field' => array('flattrwidget-static', t('Static or dynamic flattr button'), $sd, '', array('static'=>t('static'), 'dynamic'=>t('dynamic')))
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_select.tpl'), array(
+ '$field' => array('flattrwidget-align', t('Alignment of the widget'), $lr, '', array('aside'=>t('left'), 'right_aside'=>t('right')))
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_checkbox.tpl'), array(
+ '$field' => array('flattrwidget-enable', t('Enable Flattr widget'), $enable_checked, '', array(t('No'),t('Yes'))),
+ ));
+
+ $s .= replace_macros(get_markup_template('generic_addon_settings.tpl'), array(
+ '$addon' => array('flattrwidget',t('Flattr Widget Settings'), '', t('Submit')),
+ '$content' => $sc
+ ));
+
+
+}
diff --git a/sources/extend/addon/matrix/flattrwidget/img/flattr-badge-large.png b/sources/extend/addon/matrix/flattrwidget/img/flattr-badge-large.png
new file mode 100644
index 00000000..11053058
Binary files /dev/null and b/sources/extend/addon/matrix/flattrwidget/img/flattr-badge-large.png differ
diff --git a/sources/extend/addon/matrix/flattrwidget/img/red-flattr-widget.png b/sources/extend/addon/matrix/flattrwidget/img/red-flattr-widget.png
new file mode 100644
index 00000000..c7226382
Binary files /dev/null and b/sources/extend/addon/matrix/flattrwidget/img/red-flattr-widget.png differ
diff --git a/sources/extend/addon/matrix/flattrwidget/img/red-flattr-widget2.png b/sources/extend/addon/matrix/flattrwidget/img/red-flattr-widget2.png
new file mode 100644
index 00000000..84b886e7
Binary files /dev/null and b/sources/extend/addon/matrix/flattrwidget/img/red-flattr-widget2.png differ
diff --git a/sources/extend/addon/matrix/flattrwidget/style.css b/sources/extend/addon/matrix/flattrwidget/style.css
new file mode 100644
index 00000000..e69de29b
diff --git a/sources/extend/addon/matrix/fortunate/README b/sources/extend/addon/matrix/fortunate/README
new file mode 100644
index 00000000..8297cf41
--- /dev/null
+++ b/sources/extend/addon/matrix/fortunate/README
@@ -0,0 +1,7 @@
+This addon requires a fortune server. You may use the DB supplied here to create one.
+
+gunzip the fortunate.sql.gz and import into your database.
+Copy cookie.php to the top level Friendica directory.
+Edit fortunate.php and change FORTUNATE_SERVER definition to your hostname. Change the http in that file to https if your server doesn't support http.
+
+Many additional options are available if you examine cookie.php - a clever developer can provide a settings page to tailor this to one's liking. Also several languages are supported, and it would be convenient to set this to the current Friendica language if that is amongst those supported.
\ No newline at end of file
diff --git a/sources/extend/addon/matrix/fortunate/cookie.php b/sources/extend/addon/matrix/fortunate/cookie.php
new file mode 100644
index 00000000..a4be4ef0
--- /dev/null
+++ b/sources/extend/addon/matrix/fortunate/cookie.php
@@ -0,0 +1,351 @@
+real_escape_string($_GET['lang']);
+
+if(strlen($_GET['pattern']))
+ $pattern = @$db->real_escape_string($_GET['pattern']);
+
+if(strlen($_GET['regex']))
+ $regex = @$db->real_escape_string($_GET['regex']);
+
+if(strlen($_GET['db']))
+ $table = @$db->real_escape_string($_GET['db']);
+else
+ $table = '';
+
+if($length < 0)
+ $length = 0;
+if($numlines < 0)
+ $numlines = 0;
+
+function do_query($table,$length,$numlines,$adult,$cat,$limit,$lang,$pattern,$regex,$equal) {
+ global $db;
+ $rnd = mt_rand();
+ $r = array();
+
+ $typesql = (($table) ? " WHERE `category` = '$table' " : " WHERE 1 ");
+ $lengthsql = (($length) ? " AND LENGTH(`text`) < $length " : "" );
+
+ if($adult == 2)
+ $adultsql = " AND offensive = 1 ";
+ elseif($adult == 1)
+ $adultsql = "";
+ else
+ $adultsql = " AND offensive = 0 ";
+
+
+ if($numlines)
+ $lengthsql .=
+ " AND (LENGTH(`text`) - LENGTH(REPLACE(`text`,\"\n\",\"\"))) <= $numlines ";
+
+ $langsql = (($lang === 'any') ? '' : " AND lang = '$lang' ");
+
+ $patsql = '';
+ if(strlen($pattern))
+ $patsql = " AND MATCH text AGAINST ('$pattern') ";
+
+ $regexsql = '';
+ if(strlen($regex))
+ $regexsql = " AND text REGEXP '$regex' ";
+
+ $eqsql = '';
+
+ if($equal) {
+ $catsavail = array();
+ $res = @$db->query("SELECT DISTINCT ( `category` ) FROM `fortune`
+ $typesql
+ $adultsql
+ $lengthsql
+ $langsql
+ $patsql
+ $regexsql ");
+ if($res->num_rows) {
+ while($x = $res->fetch_array(MYSQL_ASSOC))
+ $catsavail[] = $x['category'];
+
+ $eqsql = " AND `category` = '"
+ . $catsavail[mt_rand(0,$res->num_rows - 1)] . "' ";
+ }
+ }
+
+ $order = (($patsql && $limit == 1) ? "" : "ORDER BY RAND($rnd)" );
+
+ $result = @$db->query("SELECT `text`, `category` FROM `fortune`
+ $typesql
+ $adultsql
+ $lengthsql
+ $langsql
+ $patsql
+ $regexsql
+ $eqsql
+ $order
+ LIMIT $limit");
+
+ if($result->num_rows) {
+ while($x = $result->fetch_array(MYSQL_ASSOC))
+ $r[] = fortune_to_html($x['text'])
+ .(($cat) ? "[{$x['category']}]
" : ""); + } + return $r; +} + + +function do_stats($table,$length,$numlines,$adult,$cat,$limit,$lang,$pattern,$regex,$equal) { + global $db; + $rnd = mt_rand(); + $r = array(); + + $typesql = (($table) ? " WHERE `category` = '$table' " : " WHERE 1 "); + $lengthsql = (($length) ? " AND LENGTH(`text`) < $length " : "" ); + + if($adult == 2) + $adultsql = " AND offensive = 1 "; + elseif($adult == 1) + $adultsql = ""; + else + $adultsql = " AND offensive = 0 "; + + + if($numlines) + $lengthsql .= + " AND (LENGTH(`text`) - LENGTH(REPLACE(`text`,\"\n\",\"\"))) <= $numlines "; + + $langsql = " AND lang = '$lang' "; + + $patsql = ''; + if(strlen($pattern)) + $patsql = " AND MATCH text AGAINST ('$pattern') "; + + $regexsql = ''; + if(strlen($regex)) + $regexsql = " AND text REGEXP '$regex' "; + + $eqsql = ''; + + $result = @$db->query("SELECT `text`, `category` FROM `fortune` + $typesql + $adultsql + $lengthsql + $langsql + $patsql + $regexsql + $eqsql"); + + + echo '
' . $result->num_rows . ' matching quotations.
'; + + + $res = @$db->query("SELECT DISTINCT ( `category` ) FROM `fortune` + $typesql + $adultsql + $lengthsql + $langsql + $patsql + $regexsql "); + if($res->num_rows) { + echo '
Matching Databases:
'; + while($x = $res->fetch_array(MYSQL_ASSOC)) + echo $x['category'].'
'; + + } + else + echo '
No matching databases using those search parameters - please refine your options.
'; + + +} + + +function fortune_to_html($s) { + + // First pass - escape all the HTML entities, and while we're at it + // get rid of any MS-DOS end-of-line characters and expand tabs to + // 8 non-breaking spaces, and translate linefeeds to
. + // We also get rid of ^G which used to sound the terminal beep or bell + // on ASCII terminals and were humourous in some fortunes. + // We could map these to autoplay a short sound file but browser support + // is still sketchy and then there's the issue of where to locate the + // URL, and a lot of people find autoplay sounds downright annoying. + // So for now, just remove them. + + $s = str_replace( + array("&", + "<", + ">", + '"', + "\007", + "\t", + "\r", + "\n"), + + array("&", + "<", + ">", + """, + "", + " ", + "", + "
"), + $s); + // Replace pseudo diacritics + // These were used to produce accented characters. For instance an accented + // e would have been encoded by '^He - the backspace moving the cursor + // backward so both the single quote and the e would appear in the same + // character position. Umlauts were quite clever - they used a double quote + // as the accent mark over a normal character. + + $s = preg_replace("/'\010([a-zA-Z])/","&\\1acute;",$s); + $s = preg_replace("/\"\010([a-zA-Z])/","&\\1uml;",$s); + $s = preg_replace("/\`\010([a-zA-Z])/","&\\1grave;",$s); + $s = preg_replace("/\^\010([a-zA-Z])/","&\\1circ;",$s); + $s = preg_replace("/\~\010([a-zA-Z])/","&\\1tilde;",$s); + + // Ignore multiple underlines for the same character. These were + // most useful when sent to a line printer back in the day as it + // would type over the same character a number of times making it + // much darker (e.g. bold). I think there are only one or two + // instances of this in the current (2008) fortune cookie database. + + $s = preg_replace("/(_\010)+/","_\010",$s); + // Map the characters which sit underneath a backspace. + // If you can come up with a regex to do all of the following + // madness - be my guest. + // It's not as simple as you think. We need to take something + // that has been backspaced over an arbitrary number of times + // and wrap a forward looking matching number of characters in + // HTML, whilst deciding if it's intended as an underline or + // strikeout sequence. + + // Essentially we produce a string of '1' and '0' characters + // the same length as the source text. + // Any position which is marked '1' has been backspaced over. + + $cursor = 0; + $dst = $s; + $bs_found = false; + for($x = 0; $x < strlen($s); $x ++) { + if($s[$x] == "\010" && $cursor) { + $bs_found = true; + $cursor --; + $dst[$cursor] = '1'; + $dst[$x] = '0'; + $continue; + } + else { + if($bs_found) { + $bs_found = false; + $cursor = $x; + } + $dst[$cursor] = '0'; + $cursor ++; + } + + } + + $out = ''; + $strike = false; + $bold = false; + + // Underline sequence, convert to bold to avoid confusion with links. + // These were generally used for emphasis so it's a reasonable choice. + // Please note that this logic will fail if there is an underline sequence + // and also a strikeout sequence in the same fortune. + + if(strstr($s,"_\010")) { + $len = 0; + for($x = 0; $x < strlen($s); $x ++) { + if($dst[$x] == '1') { + $len ++; + $bold = true; + } + else { + if($bold) { + $out .= ''; + while($s[$x] == "\010") + $x ++; + $out .= substr($s,$x,$len); + $out .= ''; + $x = $x + $len - 1; + $len = 0; + $bold = false; + } + else + $out .= $s[$x]; + } + } + } + + // These aren't seen very often these days - simulation of + // backspace/replace. You could occasionally see the original text + // on slower terminals before it got replaced. Once modems reached + // 4800/9600 baud in the late 70's and early 80's the effect was + // mostly lost - but if you find a really old fortune file you might + // encounter a few of these. + + else { + for($x = 0; $x < strlen($s); $x ++) { + if($dst[$x] == '1') { + if($strike) + $out .= $s[$x]; + else + $out .= '
' . $s['body'] . '
';
+
+}
+
+function fortunate_content(&$a) {
+
+// $o = '';
+// fortunate_fetch($a,$o);
+// return $o;
+
+}
\ No newline at end of file
diff --git a/sources/extend/addon/matrix/fortunate/fortunate.png b/sources/extend/addon/matrix/fortunate/fortunate.png
new file mode 100644
index 00000000..894a94c7
Binary files /dev/null and b/sources/extend/addon/matrix/fortunate/fortunate.png differ
diff --git a/sources/extend/addon/matrix/fortunate/fortunemod.sql.gz b/sources/extend/addon/matrix/fortunate/fortunemod.sql.gz
new file mode 100644
index 00000000..2ce0e557
Binary files /dev/null and b/sources/extend/addon/matrix/fortunate/fortunemod.sql.gz differ
diff --git a/sources/extend/addon/matrix/frphotos/frphotohelper.php b/sources/extend/addon/matrix/frphotos/frphotohelper.php
new file mode 100644
index 00000000..c2edc3e3
--- /dev/null
+++ b/sources/extend/addon/matrix/frphotos/frphotohelper.php
@@ -0,0 +1,75 @@
+get_channel();
+
+ $fr_server = $_REQUEST['fr_server'];
+ $fr_username = $_REQUEST['fr_username'];
+ $fr_password = $_REQUEST['fr_password'];
+
+ $cookies = 'store/[data]/frphoto_cookie_' . $channel['channel_address'];
+
+ if($fr_server && $fr_username && $fr_password) {
+
+ $ch = curl_init($fr_server . '/api/friendica/photos/list');
+
+ curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
+ curl_setopt ($ch, CURLOPT_COOKIEFILE, $cookies);
+ curl_setopt ($ch, CURLOPT_COOKIEJAR, $cookies);
+ curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
+ curl_setopt($ch, CURLOPT_USERPWD, $fr_username . ':' . $fr_password);
+ curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+ curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
+ curl_setopt($ch, CURLOPT_USERAGENT, 'Hubzilla');
+
+ $output = curl_exec($ch);
+ curl_close($ch);
+
+ $j = json_decode($output,true);
+
+// echo print_r($j,true);
+
+ $total = 0;
+ if(count($j)) {
+ foreach($j as $jj) {
+
+ $r = q("select uid from photo where resource_id = '%s' and uid = %d limit 1",
+ dbesc($jj),
+ intval($channel['channel_id'])
+ );
+ if($r)
+ continue;
+
+ $total ++;
+ proc_run('php','addon/frphotos/frphotohelper.php',$jj, $channel['channel_address'], urlencode($fr_server));
+ sleep(3);
+ }
+ }
+ if($total) {
+ set_pconfig(local_channel(),'frphotos','complete','1');
+ }
+ @unlink($cookies);
+ goaway(z_root() . '/photos/' . $channel['channel_address']);
+ }
+}
+
+
+function frphotos_content(&$a) {
+
+ if(! local_channel()) {
+ notice( t('Permission denied') . EOL);
+ return;
+ }
+
+ if(intval(get_pconfig(local_channel(),'frphotos','complete'))) {
+ info('Friendica photos have already been imported into this channel.');
+ return;
+ }
+
+ $o = replace_macros(get_markup_template('frphotos.tpl','addon/frphotos'),array(
+ '$header' => t('Friendica Photo Album Import'),
+ '$desc' => t('This will import all your Friendica photo albums to this Red channel.'),
+ '$fr_server' => array('fr_server', t('Friendica Server base URL'),'',''),
+ '$fr_username' => array('fr_username', t('Friendica Login Username'),'',''),
+ '$fr_password' => array('fr_password', t('Friendica Login Password'),'',''),
+ '$submit' => t('Submit'),
+ ));
+ return $o;
+}
diff --git a/sources/extend/addon/matrix/frphotos/view/tpl/frphotos.tpl b/sources/extend/addon/matrix/frphotos/view/tpl/frphotos.tpl
new file mode 100644
index 00000000..b8e97882
--- /dev/null
+++ b/sources/extend/addon/matrix/frphotos/view/tpl/frphotos.tpl
@@ -0,0 +1,13 @@
+{{$header}}
+ +{{$desc}}
+ + + diff --git a/sources/extend/addon/matrix/hexit/hexit.apd b/sources/extend/addon/matrix/hexit/hexit.apd new file mode 100644 index 00000000..af0b05fb --- /dev/null +++ b/sources/extend/addon/matrix/hexit/hexit.apd @@ -0,0 +1,3 @@ +url: $baseurl/hexit +name: Hexit +photo: $baseurl/addon/hexit/hexit.png diff --git a/sources/extend/addon/matrix/hexit/hexit.php b/sources/extend/addon/matrix/hexit/hexit.php new file mode 100644 index 00000000..bd9b7204 --- /dev/null +++ b/sources/extend/addon/matrix/hexit/hexit.php @@ -0,0 +1,185 @@ + +/** + * A function for converting hex <-> dec w/o loss of precision. + * + * The problem is that parseInt("0x12345...") isn't precise enough to convert + * 64-bit integers correctly. + * + * Internally, this uses arrays to encode decimal digits starting with the least + * significant: + * 8 = [8] + * 16 = [6, 1] + * 1024 = [4, 2, 0, 1] + */ + +// Adds two arrays for the given base (10 or 16), returning the result. +// This turns out to be the only "primitive" operation we need. +function add(x, y, base) { + var z = []; + var n = Math.max(x.length, y.length); + var carry = 0; + var i = 0; + while (i < n || carry) { + var xi = i < x.length ? x[i] : 0; + var yi = i < y.length ? y[i] : 0; + var zi = carry + xi + yi; + z.push(zi % base); + carry = Math.floor(zi / base); + i++; + } + return z; +} + +// Returns a*x, where x is an array of decimal digits and a is an ordinary +// JavaScript number. base is the number base of the array x. +function multiplyByNumber(num, x, base) { + if (num < 0) return null; + if (num == 0) return []; + + var result = []; + var power = x; + while (true) { + if (num & 1) { + result = add(result, power, base); + } + num = num >> 1; + if (num === 0) break; + power = add(power, power, base); + } + + return result; +} + +function parseToDigitsArray(str, base) { + var digits = str.split(''); + var ary = []; + for (var i = digits.length - 1; i >= 0; i--) { + var n = parseInt(digits[i], base); + if (isNaN(n)) return null; + ary.push(n); + } + return ary; +} + +function convertBase(str, fromBase, toBase) { + var digits = parseToDigitsArray(str, fromBase); + if (digits === null) return null; + + var outArray = []; + var power = [1]; + for (var i = 0; i < digits.length; i++) { + // invariant: at this point, fromBase^i = power + if (digits[i]) { + outArray = add(outArray, multiplyByNumber(digits[i], power, toBase), toBase); + } + power = multiplyByNumber(fromBase, power, toBase); + } + + var out = ''; + for (var i = outArray.length - 1; i >= 0; i--) { + out += outArray[i].toString(toBase); + } + return out; +} + +function decToHex(decStr) { + var hex = convertBase(decStr, 10, 16); + return hex ? '0x' + hex : null; +} + +function hexToDec(hexStr) { + if (hexStr.substring(0, 2) === '0x') hexStr = hexStr.substring(2); + hexStr = hexStr.toLowerCase(); + return convertBase(hexStr, 16, 10); +} + + + + function str_or_null(x) { + return x === null ? 'null' : x; + } + + // "1.234e+5" -> "12340" + function expandExponential(x) { + var pos = x.indexOf("e"); + if (pos === -1) pos = x.indexOf("E"); + if (pos === -1) return x; + + var base = x.substring(0, pos); + var pow = parseInt(x.substring(pos + 1), 10); + if (pow < 0) return x; // not supported. + + var dotPos = base.indexOf('.'); + if (dotPos === -1) dotPos = base.length; + + var ret = base.replace('.', ''); + while (ret.length < dotPos + pow) ret += '0'; + return ret; + } + + function boldDifference(correct, actual) { + for (var i = 0, j = 0; i < correct.length && j < actual.length; i++, j++) { + if (correct[i] !== actual[j]) { + break; + } + } + if (j < actual.length) { + return actual.substring(0, j) + '' + actual.substring(j) + ''; + } else { + return actual; + } + } + + function convert() { + var input = document.getElementById("in").value; + if (input) { + var aHex = str_or_null(decToHex(input)); + var aDec = str_or_null(hexToDec(input)); + var bHex = '0x' + (parseInt(input, 10)).toString(16); + var bDec = "" + expandExponential("" +parseInt(input, 16)); + + var html = 'To Decimal(' + input + ') = ' + aDec + '
'; + html += 'To Hex(' + input + ') = ' + aHex + '
'; + document.getElementById('result').innerHTML = html; + } + } + convert(); + + + + +Hexit
+ +Type in a hex or decimal string:
+ + + + + +EOT; + +return $o; +} diff --git a/sources/extend/addon/matrix/hexit/hexit.png b/sources/extend/addon/matrix/hexit/hexit.png new file mode 100644 index 00000000..990f7ead Binary files /dev/null and b/sources/extend/addon/matrix/hexit/hexit.png differ diff --git a/sources/extend/addon/matrix/ijpost/ijpost.css b/sources/extend/addon/matrix/ijpost/ijpost.css new file mode 100644 index 00000000..e69de29b diff --git a/sources/extend/addon/matrix/ijpost/ijpost.php b/sources/extend/addon/matrix/ijpost/ijpost.php new file mode 100644 index 00000000..863a2b05 --- /dev/null +++ b/sources/extend/addon/matrix/ijpost/ijpost.php @@ -0,0 +1,229 @@ + + * Author: Michael Johnston + * Author: Cat Gray '
+ . t('Post to Insanejournal') . '
';
+ }
+}
+
+
+function ijpost_settings(&$a,&$s) {
+
+ if(! local_channel())
+ return;
+
+ /* Add our stylesheet to the page so we can make our settings look nice */
+
+ //$a->page['htmlhead'] .= '' . "\r\n";
+
+ /* Get the current state of our config variables */
+
+ $enabled = get_pconfig(local_channel(),'ijpost','post');
+
+ $checked = (($enabled) ? 1 : false);
+
+ $def_enabled = get_pconfig(local_channel(),'ijpost','post_by_default');
+
+ $def_checked = (($def_enabled) ? 1 : false);
+
+ $ij_username = get_pconfig(local_channel(), 'ijpost', 'ij_username');
+ $ij_password = z_unobscure(get_pconfig(local_channel(), 'ijpost', 'ij_password'));
+
+
+ /* Add some HTML to the existing form */
+
+ $sc .= replace_macros(get_markup_template('field_checkbox.tpl'), array(
+ '$field' => array('ijpost', t('Enable InsaneJournal Post Plugin'), $checked, '', array(t('No'),t('Yes'))),
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_input.tpl'), array(
+ '$field' => array('ij_username', t('InsaneJournal username'), $ij_username, '')
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_password.tpl'), array(
+ '$field' => array('ij_password', t('InsaneJournal password'), $ij_password, '')
+ ));
+
+ $sc .= replace_macros(get_markup_template('field_checkbox.tpl'), array(
+ '$field' => array('ij_bydefault', t('Post to InsaneJournal by default'), $def_checked, '', array(t('No'),t('Yes'))),
+ ));
+
+ $s .= replace_macros(get_markup_template('generic_addon_settings.tpl'), array(
+ '$addon' => array('ijpost',t('InsaneJournal Post Settings'), '', t('Submit')),
+ '$content' => $sc
+ ));
+
+}
+
+
+function ijpost_settings_post(&$a,&$b) {
+
+ if(x($_POST,'ijpost-submit')) {
+
+ set_pconfig(local_channel(),'ijpost','post',intval($_POST['ijpost']));
+ set_pconfig(local_channel(),'ijpost','post_by_default',intval($_POST['ij_bydefault']));
+ set_pconfig(local_channel(),'ijpost','ij_username',trim($_POST['ij_username']));
+ set_pconfig(local_channel(),'ijpost','ij_password',z_obscure(trim($_POST['ij_password'])));
+ info( t('Insane Journal Settings saved.') . EOL);
+ }
+
+}
+
+function ijpost_post_local(&$a,&$b) {
+
+ // This can probably be changed to allow editing by pointing to a different API endpoint
+
+ if($b['edit'])
+ return;
+
+ if((! local_channel()) || (local_channel() != $b['uid']))
+ return;
+
+ if($b['item_private'] || $b['parent'])
+ return;
+
+ $ij_post = intval(get_pconfig(local_channel(),'ijpost','post'));
+
+ $ij_enable = (($ij_post && x($_REQUEST,'ijpost_enable')) ? intval($_REQUEST['ijpost_enable']) : 0);
+
+ if($_REQUEST['api_source'] && intval(get_pconfig(local_channel(),'ijpost','post_by_default')))
+ $ij_enable = 1;
+
+ if(! $ij_enable)
+ return;
+
+ if(strlen($b['postopts']))
+ $b['postopts'] .= ',';
+ $b['postopts'] .= 'ijpost';
+}
+
+
+
+
+function ijpost_send(&$a,&$b) {
+
+ if((! is_item_normal($b)) || $b['item_private'] || ($b['created'] !== $b['edited']))
+ return;
+
+ if(! perm_is_allowed($b['uid'],'','view_stream'))
+ return;
+
+ if(! strstr($b['postopts'],'ijpost'))
+ return;
+
+ if($b['parent'] != $b['id'])
+ return;
+
+ logger('Insanejournal xpost invoked');
+
+ // insanejournal post in the LJ user's timezone.
+ // Hopefully the person's Friendica account
+ // will be set to the same thing.
+
+ $tz = 'UTC';
+
+ $x = q("select channel_timezone from channel where channel_id = %d limit 1",
+ intval($b['uid'])
+ );
+ if($x && strlen($x[0]['channel_timezone']))
+ $tz = $x[0]['channel_timezone'];
+
+ $ij_username = get_pconfig($b['uid'],'ijpost','ij_username');
+ $ij_password = z_unobscure(get_pconfig($b['uid'],'ijpost','ij_password'));
+ $ij_blog = 'http://www.insanejournal.com/interface/xmlrpc';
+
+ if($ij_username && $ij_password && $ij_blog) {
+
+ require_once('include/bbcode.php');
+ require_once('include/datetime.php');
+
+ $title = $b['title'];
+ $post = bbcode($b['body']);
+ $post = xmlify($post);
+ $tags = ijpost_get_tags($b['tag']);
+
+ $date = datetime_convert('UTC',$tz,$b['created'],'Y-m-d H:i:s');
+ $year = intval(substr($date,0,4));
+ $mon = intval(substr($date,5,2));
+ $day = intval(substr($date,8,2));
+ $hour = intval(substr($date,11,2));
+ $min = intval(substr($date,14,2));
+
+ $xml = <<< EOT
+
+IRC chat
+A beginner's guide to using IRC. [en]
+ +EOT; + +return $o; + +} + + diff --git a/sources/extend/addon/matrix/irc/irc.png b/sources/extend/addon/matrix/irc/irc.png new file mode 100644 index 00000000..0e4b185d Binary files /dev/null and b/sources/extend/addon/matrix/irc/irc.png differ diff --git a/sources/extend/addon/matrix/jappixmini/MIT.txt b/sources/extend/addon/matrix/jappixmini/MIT.txt new file mode 100644 index 00000000..2517727f --- /dev/null +++ b/sources/extend/addon/matrix/jappixmini/MIT.txt @@ -0,0 +1,7 @@ +You may distribute all files which are not within the jappix/ folder under the following conditions: + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +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. diff --git a/sources/extend/addon/matrix/jappixmini/README b/sources/extend/addon/matrix/jappixmini/README new file mode 100644 index 00000000..0bda660f --- /dev/null +++ b/sources/extend/addon/matrix/jappixmini/README @@ -0,0 +1,27 @@ +Jappix Mini Plugin +================== + +This quick-and-dirty addon allows you to add a Jabber-based, Facebook-like chat +to Hubzilla. It uses Jappix Mini. + +It is necessary to use a BOSH host - so to use this plugin, each users need to +know the address of a BOSH host that works with his account. +It is recommended that you install your own BOSH server and recommend it using +the configuration help field. If it is on the same server, you can also deactivate the +BOSH proxy. This should improve the performance. + +The addon has an experimental autosubscribe and autosuggest functionality which +tries to add your Hubzilla contacts to your roster automatically. + +Limitations: + - Jabber passwords can only be encrypted if they are at most 39 characters + long. + +Notes on the license +-------------------- + +The license of this addon is AGPL, as required by Jappix Mini. If you make +modifications to the addon, you are responsible for providing a proper facility +for downloading the changed source code. +Moreover, it may be necessary that you publish the source code of the Friendica +application and all other used addons if you do not use standard versions. diff --git a/sources/extend/addon/matrix/jappixmini/jappix/AUTHORS b/sources/extend/addon/matrix/jappixmini/jappix/AUTHORS new file mode 100644 index 00000000..0086eb6a --- /dev/null +++ b/sources/extend/addon/matrix/jappixmini/jappix/AUTHORS @@ -0,0 +1,54 @@ +Jappix - An open social platform +These are the authors of Jappix + +------------------------------------------------- + +License: AGPL +Author: Vanaryon +Last revision: 15/01/12 + +------------------------------------------------- + +Here are the Jappix contributors, who coded or translated the application (Codingteam.net nicknames): + +# DEVELOPERS + - am0ur3ux + - LinkMauve + - Maranda + - Mathieui + - Olivier + - sim6 + - Vanaryon + +# TRANSLATORS + - allan + - Arsimael + - Belzeneph + - Catdarko + - Cerritus + - chunzu + - ebraminio + - Finkregh + - hamano + - JanCBorchardt + - jarda + - joeka + - kr2ysiek + - krohn + - Lenwe + - LinkMauve + - Liverbool + - lwj + - m1st + - Maime + - Maranda + - mbajur + - mentalo + - mkwm + - Otourly + - pocamon + - quimi + - sahwar + - Vanaryon + - vitalyster + - Zash diff --git a/sources/extend/addon/matrix/jappixmini/jappix/COPYING b/sources/extend/addon/matrix/jappixmini/jappix/COPYING new file mode 100644 index 00000000..84ae389f --- /dev/null +++ b/sources/extend/addon/matrix/jappixmini/jappix/COPYING @@ -0,0 +1,662 @@ + GNU AFFERO GENERAL PUBLIC LICENSE + Version 3, 19 November 2007 + + Copyright (C) 2007 Free Software Foundation, Inc.' + _e("Commands") + '
' +
+
+ '' +
+ '' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ '' + _e("Close") + '' +
+ '
';
+
+ // Create the popup
+ createPopup('adhoc', html);
+
+ // Associate the events
+ launchAdHoc();
+
+ return false;
+}
+
+// Quits the adhoc popup
+function closeAdHoc() {
+ // Destroy the popup
+ destroyPopup('adhoc');
+
+ return false;
+}
+
+// Retrieves an entity adhoc command
+function retrieveAdHoc(xid) {
+ // Open the popup
+ openAdHoc();
+
+ // Add a XID marker
+ $('#adhoc .adhoc-head').html('' + getBuddyName(xid).htmlEnc() + ' (' + xid.htmlEnc() + ')');
+
+ // Get the highest entity resource
+ var highest = getHighestResource(xid);
+
+ if(highest)
+ xid = highest;
+
+ // Start a new adhoc command
+ dataForm(xid, 'command', '', '', 'adhoc');
+
+ return false;
+}
+
+// Starts an adhoc command on the user server
+function serverAdHoc(server) {
+ // Open the popup
+ openAdHoc();
+
+ // Add a XID marker
+ $('#adhoc .adhoc-head').html('' + server.htmlEnc() + '');
+
+ // Start a new adhoc command
+ dataForm(server, 'command', '', '', 'adhoc');
+}
+
+// Plugin launcher
+function launchAdHoc() {
+ // Click event
+ $('#adhoc .bottom .finish').click(closeAdHoc);
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/anonymous.js b/sources/extend/addon/matrix/jappixmini/jappix/js/anonymous.js
new file mode 100644
index 00000000..88eaa7dc
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/anonymous.js
@@ -0,0 +1,131 @@
+/*
+
+Jappix - An open social platform
+These are the anonymous mode JS script for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Authors: Vanaryon, LinkMauve
+Last revision: 02/10/11
+
+*/
+
+// Connected to an anonymous session
+function anonymousConnected(con) {
+ logThis('Jappix (anonymous) is now connected.', 3);
+
+ // Connected marker
+ CONNECTED = true;
+ CURRENT_SESSION = true;
+ RECONNECT_TRY = 0;
+ RECONNECT_TIMER = 0;
+
+ // Not resumed?
+ if(!RESUME) {
+ // Create the app
+ createTalkPage();
+
+ // Send our first presence
+ firstPresence('');
+
+ // Set last activity stamp
+ LAST_ACTIVITY = getTimeStamp();
+
+ // Create the new groupchat
+ checkChatCreate(generateXID(ANONYMOUS_ROOM, 'groupchat'), 'groupchat');
+
+ // Remove some nasty elements for the anonymous mode
+ $('.tools-mucadmin, .tools-add').remove();
+ }
+
+ // Resumed
+ else {
+ // Send again our presence
+ presenceSend();
+
+ // Change the title
+ updateTitle();
+ }
+
+ // Remove the waiting icon
+ removeGeneralWait();
+}
+
+// Disconnected from an anonymous session
+function anonymousDisconnected() {
+ logThis('Jappix (anonymous) is now disconnected.', 3);
+}
+
+// Logins to a anonymous account
+function anonymousLogin(server) {
+ try {
+ // We define the http binding parameters
+ oArgs = new Object();
+
+ if(HOST_BOSH_MAIN)
+ oArgs.httpbase = HOST_BOSH_MAIN;
+ else
+ oArgs.httpbase = HOST_BOSH;
+
+ // We create the new http-binding connection
+ con = new JSJaCHttpBindingConnection(oArgs);
+
+ // And we handle everything that happen
+ con.registerHandler('message', handleMessage);
+ con.registerHandler('presence', handlePresence);
+ con.registerHandler('iq', handleIQ);
+ con.registerHandler('onconnect', anonymousConnected);
+ con.registerHandler('onerror', handleError);
+ con.registerHandler('ondisconnect', anonymousDisconnected);
+
+ // We set the anonymous connection parameters
+ oArgs = new Object();
+ oArgs.domain = server;
+ oArgs.authtype = 'saslanon';
+ oArgs.resource = JAPPIX_RESOURCE + ' Anonymous (' + (new Date()).getTime() + ')';
+ oArgs.secure = true;
+ oArgs.xmllang = XML_LANG;
+
+ // We connect !
+ con.connect(oArgs);
+
+ // Change the page title
+ pageTitle('wait');
+ }
+
+ catch(e) {
+ // Logs errors
+ logThis('Error while anonymous loggin in: ' + e, 1);
+
+ // Reset Jappix
+ anonymousDisconnected();
+
+ // Open an unknown error
+ openThisError(2);
+ }
+
+ finally {
+ return false;
+ }
+}
+
+// Plugin launcher
+function launchAnonymous() {
+ logThis('Anonymous mode detected, connecting...', 3);
+
+ // We add the login wait div
+ showGeneralWait();
+
+ // Get the vars
+ if(LINK_VARS['r'])
+ ANONYMOUS_ROOM = LINK_VARS['r'];
+ if(LINK_VARS['n'])
+ ANONYMOUS_NICK = LINK_VARS['n'];
+
+ // Fire the login action
+ anonymousLogin(HOST_ANONYMOUS);
+}
+
+// Launch this plugin!
+$(document).ready(launchAnonymous);
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/archives.js b/sources/extend/addon/matrix/jappixmini/jappix/js/archives.js
new file mode 100644
index 00000000..387a379f
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/archives.js
@@ -0,0 +1,418 @@
+/*
+
+Jappix - An open social platform
+These are the archives functions for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 03/03/11
+
+*/
+
+// Opens the archive tools
+function openArchives() {
+ // Popup HTML content
+ var html =
+ '' + _e("Message archives") + '
' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+ '' + _e("Please select a friend to view the chat history.") + '' +
+ '
' +
+
+ '' +
+ '' +
+ '' +
+
+ '' + _e("Close") + '' +
+ '
';
+
+ // Create the popup
+ createPopup('archives', html);
+
+ // Associate the events
+ launchArchives();
+
+ // Get all the buddies in our roster
+ var buddies = getAllBuddies();
+ var options = '';
+
+ for(i in buddies) {
+ var current = buddies[i];
+
+ // Add the current buddy
+ options += '';
+ }
+
+ // Can append the buddy HTML code?
+ if(options)
+ $('#archives .filter .friend').append(options);
+
+ return false;
+}
+
+// Closes the archive tools
+function closeArchives() {
+ // Destroy the popup
+ destroyPopup('archives');
+
+ return false;
+}
+
+// Gets the archives list for a buddy
+function getListArchives(xid) {
+ // Reset the archives viewer
+ $('#archives .logs').empty();
+
+ // Show the waiting icon
+ $('#archives .wait').show();
+
+ // Apply the ID
+ var id = genID();
+ $('#archives').attr('data-session', id);
+
+ // New IQ
+ var iq = new JSJaCIQ();
+ iq.setType('get');
+ iq.setID(id);
+
+ var list = iq.appendNode('list', {'xmlns': NS_URN_ARCHIVE, 'with': xid});
+ var set = list.appendChild(iq.buildNode('set', {'xmlns': NS_RSM}));
+ set.appendChild(iq.buildNode('max', {'xmlns': NS_RSM}, '0'));
+
+ con.send(iq, handleListArchives);
+
+ logThis('Getting archives list for: ' + xid + '...');
+}
+
+// Handles the archives list for a buddy
+function handleListArchives(iq) {
+ // Hide the waiting icon
+ $('#archives .wait').hide();
+
+ // Any error?
+ if(handleErrorReply(iq) || !exists('#archives[data-session=' + iq.getID() + ']'))
+ return;
+
+ // Get the last archive date
+ var last = $(iq.getNode()).find('list set changed').text();
+
+ // Any last archive?
+ if(last) {
+ // Read the date
+ var date = Date.jab2date(last);
+
+ // Change the datepicker value
+ $('#archives .filter .date').DatePickerSetDate(date, true);
+
+ // Retrieve the archives
+ checkChangeArchives();
+ }
+
+ logThis('Got archives list.', 2);
+}
+
+// Gets the archives for a day
+function getDayArchives(xid, date) {
+ // Reset the archives viewer
+ $('#archives .logs').empty();
+
+ // Show the waiting icon
+ $('#archives .wait').show();
+
+ // Apply the ID
+ var id = genID();
+ $('#archives').attr('data-session', id);
+
+ // New IQ
+ var iq = new JSJaCIQ();
+ iq.setType('get');
+ iq.setID(id);
+
+ iq.appendNode('list', {'xmlns': NS_URN_ARCHIVE, 'with': xid, 'start': date + 'T00:00:00Z', 'end': date + 'T23:59:59Z'});
+
+ con.send(iq, handleDayArchives);
+
+ logThis('Getting day archives (' + date + ') for: ' + xid + '...');
+}
+
+// Handles the archives for a day
+function handleDayArchives(iq) {
+ // Hide the waiting icon
+ $('#archives .wait').hide();
+
+ // Any error?
+ if(handleErrorReply(iq) || !exists('#archives[data-session=' + iq.getID() + ']'))
+ return;
+
+ // Get each archive thread
+ $(iq.getNode()).find('chat').each(function() {
+ // Current values
+ var xid = $(this).attr('with');
+ var start = $(this).attr('start');
+
+ if(xid && start)
+ $('#archives .logs').append('');
+ });
+
+ // Display the day
+ var date = parseDay($('#archives .filter .date').DatePickerGetDate(true) + 'T00:00:00Z' + getDateTZO());
+
+ // Try to get the first thread
+ var pending = '#archives input.archives-pending:first';
+
+ if(!exists(pending))
+ date = printf(_e("Nothing found for: %s"), date);
+
+ else {
+ retrieveArchives($(pending).attr('data-with'), $(pending).attr('data-start'));
+ $(pending).remove();
+ }
+
+ $('#archives .current .time').text(date);
+
+ logThis('Got day archives.', 2);
+}
+
+// Retrieves a specified archive collection
+function retrieveArchives(xid, start) {
+ // Show the waiting icon
+ $('#archives .wait').show();
+
+ // Apply the ID
+ var id = genID();
+ $('#archives').attr('data-session', id);
+
+ // New IQ
+ var iq = new JSJaCIQ();
+ iq.setType('get');
+ iq.setID(id);
+
+ var list = iq.appendNode('retrieve', {'xmlns': NS_URN_ARCHIVE, 'with': xid, 'start': start});
+
+ con.send(iq, handleRetrieveArchives);
+
+ logThis('Retrieving archives (start: ' + start + ') for: ' + xid + '...');
+}
+
+// Handles a specified archive collection
+function handleRetrieveArchives(iq) {
+ // Hide the waiting icon
+ $('#archives .wait').hide();
+
+ // Any error?
+ if(handleErrorReply(iq) || !exists('#archives[data-session=' + iq.getID() + ']'))
+ return;
+
+ // Get the node
+ var chat = $(iq.getNode()).find('chat:first');
+
+ // Get the buddy XID
+ var xid = bareXID(chat.attr('with'));
+
+ // Get the start date & stamp
+ var start_date = Date.jab2date(chat.attr('start'));
+ var start_stamp = extractStamp(start_date);
+
+ // Parse the result chat
+ chat.find('to, from').each(function() {
+ var node = (this).nodeName;
+ var stamp = start_stamp + parseInt($(this).attr('secs'));
+ var date = extractTime(new Date(stamp * 1000));
+ var body = $(this).find('body').text();
+
+ // Is it my message?
+ if((node == 'to') && body)
+ displayMessage('chat', getXID(), 'archives', getBuddyName(getXID()).htmlEnc(), body, date, start_stamp, 'user-message', true, '', 'me');
+
+ // Is it a buddy message?
+ else if((node == 'from') && body)
+ displayMessage('chat', xid, 'archives', getBuddyName(xid).htmlEnc(), body, date, start_stamp, 'user-message', true, '', 'him');
+ });
+
+ // Not the latest thread?
+ var pending = '#archives input.archives-pending:first';
+
+ if(exists(pending)) {
+ retrieveArchives($(pending).attr('data-with'), $(pending).attr('data-start'));
+ $(pending).remove();
+ }
+
+ // Everything has been retrieved, get the avatars
+ else {
+ getAvatar(getXID(), 'cache', 'true', 'forget');
+ getAvatar(xid, 'cache', 'true', 'forget');
+ }
+
+ logThis('Got archives.', 2);
+}
+
+// Gets the archiving configuration
+function getConfigArchives() {
+ // Lock the archiving options
+ $('#archiving').attr('checked', false).attr('disabled', true);
+
+ // Get the archiving configuration
+ var iq = new JSJaCIQ();
+ iq.setType('get');
+
+ iq.appendNode('pref', {'xmlns': NS_URN_ARCHIVE});
+
+ con.send(iq, handleGetConfigArchives);
+}
+
+// Handles the archiving configuration
+function handleGetConfigArchives(iq) {
+ // Reset the options stuffs
+ waitOptions('archives');
+
+ // Unlock the archiving options
+ $('#archiving').removeAttr('disabled');
+
+ // End if not a result
+ if(!iq || (iq.getType() != 'result'))
+ return;
+
+ // Extract the preferences from the IQ
+ var enabled = $(iq.getNode()).find('pref auto').attr('save');
+
+ // Define the input enabling/disabling vars
+ var checked = true;
+
+ if(enabled != 'true')
+ checked = false;
+
+ // Apply the values
+ $('#archiving').attr('checked', checked);
+}
+
+// Configures the archiving on the server
+function configArchives(enabled) {
+ // Configure the auto element
+ var iq = new JSJaCIQ();
+ iq.setType('set');
+
+ iq.appendNode('auto', {'xmlns': NS_URN_ARCHIVE, 'save': enabled});
+
+ con.send(iq, handleConfigArchives);
+
+ // Configure the default element
+ var iq = new JSJaCIQ();
+ iq.setType('set');
+
+ var pref = iq.appendNode('pref', {'xmlns': NS_URN_ARCHIVE});
+ pref.appendChild(iq.appendNode('default', {'xmlns': NS_URN_ARCHIVE, 'otr': 'concede', 'save': 'body'}));
+
+ con.send(iq);
+
+ // Configure the method element
+ var iq = new JSJaCIQ();
+ iq.setType('set');
+
+ var mType = new Array('auto', 'local', 'manual');
+ var mUse = new Array('prefer', 'concede', 'concede');
+
+ var pref = iq.appendNode('pref', {'xmlns': NS_URN_ARCHIVE});
+
+ for(i in mType)
+ pref.appendChild(iq.appendNode('method', {'xmlns': NS_URN_ARCHIVE, 'type': mType[i], 'use': mUse[i]}));
+
+ con.send(iq);
+
+ // Logger
+ logThis('Configuring archives...', 3);
+}
+
+// Handles the archives configuration
+function handleConfigArchives(iq) {
+ if(!iq || (iq.getType() != 'result'))
+ logThis('Archives not configured.', 2);
+ else
+ logThis('Archives configured.', 3);
+}
+
+// Checks if the datepicker has changed
+function checkChangeArchives() {
+ var xid = $('#archives .filter .friend').val();
+ var date = $('#archives .filter .date').DatePickerGetDate(true);
+
+ // No XID?
+ if(!xid || !xid.length)
+ return;
+
+ // Too many value?
+ if(xid.length > 1) {
+ $('#archives .filter .friend').val(xid[0]);
+
+ return;
+ }
+
+ // Get the first XID
+ xid = xid[0];
+
+ // Get the archives
+ getDayArchives(xid, date);
+}
+
+// Update the archives with the selected XID
+function updateArchives() {
+ // Read the values
+ var xid = $('#archives .filter .friend').val();
+ var date = $('#archives .filter .date').DatePickerGetDate(true);
+
+ // No XID?
+ if(!xid || !xid.length)
+ return;
+
+ // Too many value?
+ if(xid.length > 1) {
+ $('#archives .filter .friend').val(xid[0]);
+
+ return;
+ }
+
+ // Get the first XID
+ xid = xid[0];
+
+ // Apply the current marker
+ $('#archives .current .name').text(getBuddyName(xid));
+ $('#archives .current .time').text(parseDay(date + 'T00:00:00Z' + getDateTZO()));
+
+ // Get the archives
+ getListArchives(xid, date);
+}
+
+// Plugin launcher
+function launchArchives() {
+ // Current date
+ var current_date = explodeThis('T', getXMPPTime(), 0);
+
+ // Datepicker
+ $('#archives .filter .date').DatePicker({
+ flat: true,
+ date: current_date,
+ current: current_date,
+ calendars: 1,
+ starts: 1,
+ onChange: checkChangeArchives
+ });
+
+ // Click events
+ $('#archives .bottom .finish').click(function() {
+ return closeArchives();
+ });
+
+ // Change event
+ $('#archives .filter .friend').change(updateArchives);
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/audio.js b/sources/extend/addon/matrix/jappixmini/jappix/js/audio.js
new file mode 100644
index 00000000..f83583a9
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/audio.js
@@ -0,0 +1,46 @@
+/*
+
+Jappix - An open social platform
+These are the audio JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 10/08/11
+
+*/
+
+// Plays the given sound ID
+function soundPlay(num) {
+ try {
+ // Not supported!
+ if((BrowserDetect.browser == 'Explorer') && (BrowserDetect.version < 9))
+ return false;
+
+ // If the sounds are enabled
+ if(getDB('options', 'sounds') == '1') {
+ // If the audio elements aren't yet in the DOM
+ if(!exists('#audio')) {
+ $('body').append(
+ '' +
+ '' +
+ '' +
+ '' +
+ '
'
+ );
+ }
+
+ // We play the target sound
+ var playThis = document.getElementById('audio').getElementsByTagName('audio')[num];
+ playThis.load();
+ playThis.play();
+ }
+ }
+
+ catch(e) {}
+
+ finally {
+ return false;
+ }
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/autocompletion.js b/sources/extend/addon/matrix/jappixmini/jappix/js/autocompletion.js
new file mode 100644
index 00000000..52d3c47e
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/autocompletion.js
@@ -0,0 +1,99 @@
+/*
+
+Jappix - An open social platform
+These are the autocompletion tools JS script for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 12/11/10
+
+*/
+
+// Sort an array with insensitivity to the case
+function caseInsensitiveSort(a, b) {
+ // Put the two strings into lower case
+ a = a.toLowerCase();
+ b = b.toLowerCase();
+
+ // Process the sort
+ if(a > b)
+ return 1;
+ if(a < b)
+ return -1;
+}
+
+// Creates an array with the autocompletion results
+function processAutocompletion(query, id) {
+ // Replace forbidden characters in regex
+ query = escapeRegex(query);
+
+ // Create an empty array
+ var results = new Array();
+
+ // Search in the roster
+ $('#' + id + ' .user').each(function() {
+ var nick = $(this).find('.name').text();
+ var regex = new RegExp('(^)' + query, 'gi');
+
+ if(nick.match(regex))
+ results.push(nick);
+ });
+
+ // Sort the array
+ results = results.sort(caseInsensitiveSort);
+
+ // Return the results array
+ return results;
+}
+
+// Resets the autocompletion tools
+function resetAutocompletion(hash) {
+ $('#' + hash + ' .message-area').removeAttr('data-autocompletion-pointer').removeAttr('data-autocompletion-query');
+}
+
+// Autocompletes the chat input nick
+function createAutocompletion(hash) {
+ // Initialize
+ var vSelector = $('#' + hash + ' .message-area');
+ var value = vSelector.val();
+ if(!value)
+ resetAutocompletion(hash);
+ var query = vSelector.attr('data-autocompletion-query');
+
+ // The autocompletion has not been yet launched
+ if(query == undefined) {
+ query = value;
+ vSelector.attr('data-autocompletion-query', query);
+ }
+
+ // Get the pointer
+ var pointer = vSelector.attr('data-autocompletion-pointer');
+ var i = 0;
+
+ if(pointer)
+ i = parseInt(pointer);
+
+ // We get the nickname
+ var nick = processAutocompletion(query, hash)[i];
+
+ // Shit, this is my nick!
+ if((nick != undefined) && (nick.toLowerCase() == getMUCNick(hash).toLowerCase())) {
+ // Increment
+ i++;
+
+ // Get the next nick
+ nick = processAutocompletion(query, hash)[i];
+ }
+
+ // We quote the nick
+ if(nick != undefined) {
+ // Increment
+ i++;
+ quoteMyNick(hash, nick);
+
+ // Put a pointer
+ vSelector.attr('data-autocompletion-pointer', i);
+ }
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/avatar.js b/sources/extend/addon/matrix/jappixmini/jappix/js/avatar.js
new file mode 100644
index 00000000..4234ffc7
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/avatar.js
@@ -0,0 +1,205 @@
+/*
+
+Jappix - An open social platform
+These are the avatar JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 01/03/11
+
+*/
+
+// Requests the avatar of a given user
+var AVATAR_PENDING = [];
+
+function getAvatar(xid, mode, enabled, photo) {
+ /* REF: http://xmpp.org/extensions/xep-0153.html */
+
+ // No need to get the avatar, another process is yet running
+ if(existArrayValue(AVATAR_PENDING, xid))
+ return false;
+
+ // Initialize: XML data is in one SQL entry, because some browser are sloooow with SQL requests
+ var xml = XMLFromString(getPersistent('avatar', xid));
+ var forced = false;
+
+ // Retrieving forced?
+ if($(xml).find('forced').text() == 'true')
+ forced = true;
+
+ // No avatar in presence
+ if(!photo && !forced && (enabled == 'true')) {
+ // Pending marker
+ AVATAR_PENDING.push(xid);
+
+ // Reset the avatar
+ resetAvatar(xid, hex_md5(xid));
+
+ logThis('No avatar for: ' + xid, 2);
+ }
+
+ // Try to catch the avatar
+ else {
+ // Define some stuffs
+ var type = $(xml).find('type').text();
+ var binval = $(xml).find('binval').text();
+ var checksum = $(xml).find('checksum').text();
+ var updated = false;
+
+ // Process the checksum of the avatar
+ if((checksum == photo) || (photo == 'forget') || forced)
+ updated = true;
+
+ // If the avatar is yet stored and a new retrieving is not needed
+ if((mode == 'cache') && type && binval && checksum && updated) {
+ // Pending marker
+ AVATAR_PENDING.push(xid);
+
+ // Display the cache avatar
+ displayAvatar(xid, hex_md5(xid), type, binval);
+
+ logThis('Read avatar from cache: ' + xid, 3);
+ }
+
+ // Else if the request has not yet been fired, we get it
+ else if((!updated || (mode == 'cache' && !updated) || (mode == 'force') || (photo = 'forget')) && (enabled != 'false')) {
+ // Pending marker
+ AVATAR_PENDING.push(xid);
+
+ // Get the latest avatar
+ var iq = new JSJaCIQ();
+ iq.setType('get');
+ iq.setTo(xid);
+
+ iq.appendNode('vCard', {'xmlns': NS_VCARD});
+
+ con.send(iq, handleAvatar);
+
+ logThis('Get avatar from server: ' + xid, 3);
+ }
+ }
+
+ return true;
+}
+
+// Handles the avatar
+function handleAvatar(iq) {
+ // Extract the XML values
+ var handleXML = iq.getNode();
+ var handleFrom = fullXID(getStanzaFrom(iq));
+
+ // Is this me? Remove the resource!
+ if(bareXID(handleFrom) == getXID())
+ handleFrom = bareXID(handleFrom);
+
+ // Get some other values
+ var hash = hex_md5(handleFrom);
+ var find = $(handleXML).find('vCard');
+ var aChecksum = 'none';
+ var oChecksum = null;
+
+ // Read our own checksum
+ if(handleFrom == getXID()) {
+ oChecksum = getDB('checksum', 1);
+
+ // Avoid the "null" value
+ if(!oChecksum)
+ oChecksum = '';
+ }
+
+ // vCard not empty?
+ if(find.size()) {
+ // We get our profile details
+ if(handleFrom == getXID()) {
+ // Get the names
+ var names = generateBuddyName(iq);
+
+ // Write the values to the database
+ setDB('profile', 'name', names[0]);
+ setDB('profile', 'nick', names[1]);
+ }
+
+ // We get the avatar
+ var aType = find.find('TYPE:first').text();
+ var aBinval = find.find('BINVAL:first').text();
+
+ // No binval?
+ if(!aBinval) {
+ aType = 'none';
+ aBinval = 'none';
+ }
+
+ // Enough data
+ else {
+ // No type?
+ if(!aType)
+ aType = 'image/png';
+
+ // Process the checksum
+ else
+ aChecksum = hex_sha1(Base64.decode(aBinval));
+ }
+
+ // We display the user avatar
+ displayAvatar(handleFrom, hash, aType, aBinval);
+
+ // Store the avatar
+ setPersistent('avatar', handleFrom, ' && (binval != 'none'))
+ code += 'data:' + type + ';base64,' + binval;
+ else
+ code += './img/others/default-avatar.png';
+
+ code += '){kind=avatar}
';
+
+ // Replace with the new avatar (in the roster and in the chat)
+ $('.' + container).html(code);
+
+ // We can remove the pending marker
+ removeArrayValue(AVATAR_PENDING, xid);
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/base64.js b/sources/extend/addon/matrix/jappixmini/jappix/js/base64.js
new file mode 100644
index 00000000..1cf2dc74
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/base64.js
@@ -0,0 +1,80 @@
+// This code was written by Tyler Akins and has been placed in the
+// public domain. It would be nice if you left this header intact.
+// Base64 code from Tyler Akins -- http://rumkin.com
+
+var Base64 = (function () {
+ var keyStr = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
+
+ var obj = {
+ /**
+ * Encodes a string in base64
+ * @param {String} input The string to encode in base64.
+ */
+ encode: function (input) {
+ var output = "";
+ var chr1, chr2, chr3;
+ var enc1, enc2, enc3, enc4;
+ var i = 0;
+
+ do {
+ chr1 = input.charCodeAt(i++);
+ chr2 = input.charCodeAt(i++);
+ chr3 = input.charCodeAt(i++);
+
+ enc1 = chr1 >> 2;
+ enc2 = ((chr1 & 3) << 4) | (chr2 >> 4);
+ enc3 = ((chr2 & 15) << 2) | (chr3 >> 6);
+ enc4 = chr3 & 63;
+
+ if (isNaN(chr2)) {
+ enc3 = enc4 = 64;
+ } else if (isNaN(chr3)) {
+ enc4 = 64;
+ }
+
+ output = output + keyStr.charAt(enc1) + keyStr.charAt(enc2) +
+ keyStr.charAt(enc3) + keyStr.charAt(enc4);
+ } while (i < input.length);
+
+ return output;
+ },
+
+ /**
+ * Decodes a base64 string.
+ * @param {String} input The string to decode.
+ */
+ decode: function (input) {
+ var output = "";
+ var chr1, chr2, chr3;
+ var enc1, enc2, enc3, enc4;
+ var i = 0;
+
+ // remove all characters that are not A-Z, a-z, 0-9, +, /, or =
+ input = input.replace(/[^A-Za-z0-9\+\/\=]/g, "");
+
+ do {
+ enc1 = keyStr.indexOf(input.charAt(i++));
+ enc2 = keyStr.indexOf(input.charAt(i++));
+ enc3 = keyStr.indexOf(input.charAt(i++));
+ enc4 = keyStr.indexOf(input.charAt(i++));
+
+ chr1 = (enc1 << 2) | (enc2 >> 4);
+ chr2 = ((enc2 & 15) << 4) | (enc3 >> 2);
+ chr3 = ((enc3 & 3) << 6) | enc4;
+
+ output = output + String.fromCharCode(chr1);
+
+ if (enc3 != 64) {
+ output = output + String.fromCharCode(chr2);
+ }
+ if (enc4 != 64) {
+ output = output + String.fromCharCode(chr3);
+ }
+ } while (i < input.length);
+
+ return output;
+ }
+ };
+
+ return obj;
+})();
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/board.js b/sources/extend/addon/matrix/jappixmini/jappix/js/board.js
new file mode 100644
index 00000000..1d26acee
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/board.js
@@ -0,0 +1,141 @@
+/*
+
+Jappix - An open social platform
+These are the notification board JS script for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 12/03/11
+
+*/
+
+// Creates a board panel
+function createBoard(type, id) {
+ // Text var
+ var text = '';
+
+ // Info
+ if(type == 'info') {
+ switch(id) {
+ // Password change
+ case 1:
+ text = _e("Your password has been changed, now you can connect to your account with your new login data.");
+
+ break;
+
+ // Account deletion
+ case 2:
+ text = _e("Your XMPP account has been removed, bye!");
+
+ break;
+
+ // Account logout
+ case 3:
+ text = _e("You have been logged out of your XMPP account, have a nice day!");
+
+ break;
+
+ // Groupchat join
+ case 4:
+ text = _e("The room you joined seems not to exist. You should create it!");
+
+ break;
+
+ // Groupchat removal
+ case 5:
+ text = _e("The groupchat has been removed, now someone else will be able to recreate it.");
+
+ break;
+
+ // Non-existant groupchat user
+ case 6:
+ text = _e("The user that you want to reach is not present in the room.");
+
+ break;
+ }
+ }
+
+ // Error
+ else {
+ switch(id) {
+ // Custom error
+ case 1:
+ text = '' + _e("Error") + ' » ';
+
+ break;
+
+ // Network error
+ case 2:
+ text = _e("Jappix has been interrupted by a network issue, a bug or bad login (check that you entered the right credentials), sorry for the inconvenience.");
+
+ break;
+
+ // List retrieving error
+ case 3:
+ text = _e("The element list on this server could not be obtained!");
+
+ break;
+
+ // Attaching error
+ case 4:
+ text = printf(_e("An error occured while uploading your file: maybe it is too big (%s maximum) or forbidden!"), JAPPIX_MAX_UPLOAD);
+
+ break;
+ }
+ }
+
+ // No text?
+ if(!text)
+ return false;
+
+ // Append the content
+ $('#board').append('' + text + '
');
+
+ // Events (click and auto-hide)
+ $('#board .one-board.' + type + '[data-id=' + id + ']')
+
+ .click(function() {
+ closeThisBoard(this);
+ })
+
+ .oneTime('5s', function() {
+ closeThisBoard(this);
+ })
+
+ .slideDown();
+
+ return true;
+}
+
+// Destroys the existing board notifications
+function destroyBoard() {
+ $('#board').empty();
+}
+
+// Executes a given action on the notification board
+function actionBoard(id, type) {
+ // In a first, we destroy other boards
+ destroyBoard();
+
+ // Then we display the board
+ createBoard(type, id);
+}
+
+// Opens a given error ID
+function openThisError(id) {
+ actionBoard(id, 'error');
+}
+
+// Opens a given info ID
+function openThisInfo(id) {
+ actionBoard(id, 'info');
+}
+
+// Closes a given board
+function closeThisBoard(board) {
+ $(board).slideUp('normal', function() {
+ $(this).remove();
+ });
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/browser-detect.js b/sources/extend/addon/matrix/jappixmini/jappix/js/browser-detect.js
new file mode 100644
index 00000000..39edaf2b
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/browser-detect.js
@@ -0,0 +1,124 @@
+/* BROWSER DETECT
+ * http://www.quirksmode.org/js/detect.html
+ */
+
+var BrowserDetect = {
+ init: function () {
+ this.browser = this.searchString(this.dataBrowser) || "An unknown browser";
+ this.version = this.searchVersion(navigator.userAgent)
+ || this.searchVersion(navigator.appVersion)
+ || "an unknown version";
+ this.OS = this.searchString(this.dataOS) || "an unknown OS";
+ },
+
+ searchString: function (data) {
+ for (var i=0;i' + _e("Moderators") + '
' + _e("Participants") + '
' + _e("Visitors") + '
' + _e("Others") + '
'; + specialCode = ''; + specialLink = ''; + specialStyle = ' style="display: none;"'; + specialDisabled = ''; + } + + // Not a groupchat private chat, we can use the buddy add icon + if((type == 'chat') || (type == 'groupchat')) { + var addTitle; + + if(type == 'chat') + addTitle = _e("Add this contact to your friends"); + else + addTitle = _e("Add this groupchat to your favorites"); + + specialLink += ''; + } + + // IE DOM parsing bug fix + var specialStylePicker = ''; + + if((BrowserDetect.browser == 'Explorer') && (BrowserDetect.version < 9)) + specialStylePicker = ''; + + // Append the chat HTML code + $('#page-engine').append( + '
' +
+ '
'
+ );
+
+ // Click event: chat cleaner
+ $(path + 'tools-clear').click(function() {
+ cleanChat(id);
+ });
+
+ // Click event: user-infos
+ $(path + 'tools-infos').click(function() {
+ openUserInfos(xid);
+ });
+}
+
+// Generates the chat switch elements
+function generateSwitch(type, id, xid, nick) {
+ // Path to the element
+ var chat_switch = '#page-switch .';
+
+ // Special code
+ var specialClass = ' unavailable';
+ var show_close = true;
+
+ // Groupchat
+ if(type == 'groupchat') {
+ specialClass = ' groupchat-default';
+
+ if(isAnonymous() && (xid == generateXID(ANONYMOUS_ROOM, 'groupchat')))
+ show_close = false;
+ }
+
+ // Generate the HTML code
+ var html = '' +
+ specialAvatar +
+
+ '
' +
+
+ specialCode +
+
+ '' +
+ '
' +
+ '' + nick.htmlEnc() + '
' + + specialName + + '' +
+ '' +
+
+ '
' +
+ '' +
+ '' +
+ '
' +
+ '' +
+ '' +
+
+ '
';
+
+ // Append the HTML code
+ $(chat_switch + 'chans, ' + chat_switch + 'more-content').append(html);
+}
+
+// Cleans given the chat lines
+function cleanChat(chat) {
+ $('#page-engine #' + chat + ' .content .one-group').remove();
+
+ $(document).oneTime(10, function() {
+ $('#page-engine #' + chat + ' .text .message-area').focus();
+ });
+}
+
+// Creates a new chat
+function chatCreate(hash, xid, nick, type) {
+ logThis('New chat: ' + xid, 3);
+
+ // Create the chat content
+ generateChat(type, hash, xid, nick);
+
+ // Create the chat switcher
+ generateSwitch(type, hash, xid, nick);
+
+ // If the user is not in our buddy-list
+ if(type == 'chat') {
+ // Add button
+ if(!exists('#buddy-list .buddy[data-xid=' + escape(xid) + ']'))
+ $('#' + hash + ' .tools-add').click(function() {
+ // Hide the icon (to tell the user all is okay)
+ $(this).hide();
+
+ // Send the subscribe request
+ addThisContact(xid, nick);
+ }).show();
+
+ // Archives button
+ else if(enabledArchives() || enabledArchives('auto') || enabledArchives('manual') || enabledArchives('manage'))
+ $('#' + hash + ' .tools-archives').click(function() {
+ // Open the archives popup
+ openArchives();
+
+ // Get the archives for this user
+ $('#archives .filter .friend').val(xid);
+ updateArchives();
+ }).show();
+ }
+
+ // We catch the user's informations (like this avatar, vcard, and so on...)
+ getUserInfos(hash, xid, nick, type);
+
+ // The icons-hover functions
+ tooltipIcons(xid, hash);
+
+ // The event handlers
+ var inputDetect = $('#page-engine #' + hash + ' .message-area');
+
+ inputDetect.focus(function() {
+ chanCleanNotify(hash);
+ })
+
+ inputDetect.keypress(function(e) {
+ // Enter key
+ if(e.keyCode == 13) {
+ // Add a new line
+ if(e.shiftKey)
+ inputDetect.val(inputDetect.val() + '\n');
+
+ // Send the message
+ else {
+ // Send the message
+ sendMessage(hash, 'chat');
+
+ // Reset the composing database entry
+ setDB('chatstate', xid, 'off');
+ }
+
+ return false;
+ }
+ });
+
+ // Chatstate events
+ eventsChatState(inputDetect, xid, hash);
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/chatstate.js b/sources/extend/addon/matrix/jappixmini/jappix/js/chatstate.js
new file mode 100644
index 00000000..de7e7966
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/chatstate.js
@@ -0,0 +1,174 @@
+/*
+
+Jappix - An open social platform
+These are the chatstate JS script for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 25/08/11
+
+*/
+
+// Sends a given chatstate to a given entity
+function chatStateSend(state, xid, hash) {
+ var user_type = $('#' + hash).attr('data-type');
+
+ // If the friend client supports chatstates and is online
+ if((user_type == 'groupchat') || ((user_type == 'chat') && $('#' + hash + ' .message-area').attr('data-chatstates') && !exists('#page-switch .' + hash + ' .unavailable'))) {
+ // Already sent?
+ if(getDB('currentchatstate', xid) == state)
+ return;
+
+ // Write the state
+ setDB('currentchatstate', xid, state);
+
+ // New message stanza
+ var aMsg = new JSJaCMessage();
+ aMsg.setTo(xid);
+ aMsg.setType(user_type);
+
+ // Append the chatstate node
+ aMsg.appendNode(state, {'xmlns': NS_CHATSTATES});
+
+ // Send this!
+ con.send(aMsg);
+ }
+}
+
+// Displays a given chatstate in a given chat
+function displayChatState(state, hash, type) {
+ // Groupchat?
+ if(type == 'groupchat') {
+ resetChatState(hash, type);
+
+ // "gone" state not allowed
+ if(state != 'gone')
+ $('#page-engine .page-engine-chan .user.' + hash).addClass(state);
+ }
+
+ // Chat
+ else {
+ // We change the buddy name color in the page-switch
+ resetChatState(hash, type);
+ $('#page-switch .' + hash + ' .name').addClass(state);
+
+ // We generate the chatstate text
+ var text = '';
+
+ switch(state) {
+ // Active
+ case 'active':
+ text = _e("Your friend is paying attention to the conversation.");
+
+ break;
+
+ // Composing
+ case 'composing':
+ text = _e("Your friend is writing a message...");
+
+ break;
+
+ // Paused
+ case 'paused':
+ text = _e("Your friend stopped writing a message.");
+
+ break;
+
+ // Inactive
+ case 'inactive':
+ text = _e("Your friend is doing something else.");
+
+ break;
+
+ // Gone
+ case 'gone':
+ text = _e("Your friend closed the chat.");
+
+ break;
+ }
+
+ // We reset the previous state
+ $('#' + hash + ' .chatstate').remove();
+
+ // We create the chatstate
+ $('#' + hash + ' .content').after('' + nick.htmlEnc() + '
';
+
+ // Show the close button if not MUC and not anonymous
+ if(show_close)
+ html += 'x
';
+
+ // Close the HTML
+ html += '' + text + '
');
+ }
+}
+
+// Resets the chatstate switcher marker
+function resetChatState(hash, type) {
+ // Define the selector
+ var selector;
+
+ if(type == 'groupchat')
+ selector = $('#page-engine .page-engine-chan .user.' + hash);
+ else
+ selector = $('#page-switch .' + hash + ' .name');
+
+ // Reset!
+ selector.removeClass('active')
+ selector.removeClass('composing')
+ selector.removeClass('paused')
+ selector.removeClass('inactive')
+ selector.removeClass('gone');
+}
+
+// Adds the chatstate events
+function eventsChatState(target, xid, hash) {
+ target.keyup(function(e) {
+ if(e.keyCode != 13) {
+ // Composing a message
+ if($(this).val() && (getDB('chatstate', xid) != 'on')) {
+ // We change the state detect input
+ setDB('chatstate', xid, 'on');
+
+ // We send the friend a "composing" chatstate
+ chatStateSend('composing', xid, hash);
+ }
+
+ // Stopped composing a message
+ else if(!$(this).val() && (getDB('chatstate', xid) == 'on')) {
+ // We change the state detect input
+ setDB('chatstate', xid, 'off');
+
+ // We send the friend an "active" chatstate
+ chatStateSend('active', xid, hash);
+ }
+ }
+ });
+
+ target.change(function() {
+ // Reset the composing database entry
+ setDB('chatstate', xid, 'off');
+ });
+
+ target.focus(function() {
+ // Not needed
+ if(target.is(':disabled'))
+ return;
+
+ // Nothing in the input, user is active
+ if(!$(this).val())
+ chatStateSend('active', xid, hash);
+
+ // Something was written, user started writing again
+ else
+ chatStateSend('composing', xid, hash);
+ });
+
+ target.blur(function() {
+ // Not needed
+ if(target.is(':disabled'))
+ return;
+
+ // Nothing in the input, user is inactive
+ if(!$(this).val())
+ chatStateSend('inactive', xid, hash);
+
+ // Something was written, user paused
+ else
+ chatStateSend('paused', xid, hash);
+ });
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/common.js b/sources/extend/addon/matrix/jappixmini/jappix/js/common.js
new file mode 100644
index 00000000..ab10d6e7
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/common.js
@@ -0,0 +1,311 @@
+/*
+
+Jappix - An open social platform
+These are the common JS script for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Authors: Vanaryon, olivierm
+Last revision: 24/06/11
+
+*/
+
+// Checks if an element exists in the DOM
+function exists(selector) {
+ if(jQuery(selector).size() > 0)
+ return true;
+ else
+ return false;
+}
+
+// Checks if Jappix is connected
+function isConnected() {
+ if((typeof con != 'undefined') && con && con.connected())
+ return true;
+
+ return false;
+}
+
+// Checks if Jappix has focus
+function isFocused() {
+ try {
+ if(document.hasFocus())
+ return true;
+
+ return false;
+ }
+
+ catch(e) {
+ return true;
+ }
+}
+
+// Generates the good XID
+function generateXID(xid, type) {
+ // XID needs to be transformed
+ if(xid && (xid.indexOf('@') == -1)) {
+ // Groupchat
+ if(type == 'groupchat')
+ return xid + '@' + HOST_MUC;
+
+ // One-to-one chat
+ if(xid.indexOf('.') == -1)
+ return xid + '@' + HOST_MAIN;
+
+ // It might be a gateway?
+ return xid;
+ }
+
+ // Nothing special (yet bare XID)
+ return xid;
+}
+
+// Gets the asked translated string
+function _e(string) {
+ return string;
+}
+
+// Replaces '%s' to a given value for a translated string
+function printf(string, value) {
+ return string.replace('%s', value);
+}
+
+// Properly explodes a string with a given character
+function explodeThis(toEx, toStr, i) {
+ // Get the index of our char to explode
+ var index = toStr.indexOf(toEx);
+
+ // We split if necessary the string
+ if(index != -1) {
+ if(i == 0)
+ toStr = toStr.substr(0, index);
+ else
+ toStr = toStr.substr(index + 1);
+ }
+
+ // We return the value
+ return toStr;
+}
+
+// Cuts the resource of a XID
+function cutResource(aXID) {
+ return explodeThis('/', aXID, 0);
+}
+
+// Gets the resource of a XID
+function thisResource(aXID) {
+ // Any resource?
+ if(aXID.indexOf('/') != -1)
+ return explodeThis('/', aXID, 1);
+
+ // No resource
+ return '';
+}
+
+// Does stringprep on a string
+function stringPrep(string) {
+ // Replacement arrays
+ var invalid = new Array('Å ', 'Å¡', 'Ä', 'Ä‘', 'Ž', 'ž', 'ÄŒ', 'Ä', 'Ć', 'ć', 'À', 'Ã', 'Â', 'Ã', 'Ä', 'Ã…', 'Æ', 'Ç', 'È', 'É', 'Ê', 'Ë', 'ÃŒ', 'Ã', 'ÃŽ', 'Ã', 'Ñ', 'Ã’', 'Ó', 'Ô', 'Õ', 'Ö', 'Ø', 'Ù', 'Ú', 'Û', 'Ãœ', 'Ã', 'Þ', 'ß', 'à ', 'á', 'â', 'ã', 'ä', 'Ã¥', 'æ', 'ç', 'è', 'é', 'ê', 'ë', 'ì', 'Ã', 'î', 'ï', 'ð', 'ñ', 'ò', 'ó', 'ô', 'õ', 'ö', 'ø', 'ù', 'ú', 'û', 'ý', 'þ', 'ÿ', 'Å”', 'Å•');
+
+ var valid = new Array('S', 's', 'Dj', 'dj', 'Z', 'z', 'C', 'c', 'C', 'c', 'A', 'A', 'A', 'A', 'A', 'A', 'A', 'C', 'E', 'E', 'E', 'E', 'I', 'I', 'I', 'I', 'N', 'O', 'O', 'O', 'O', 'O', 'O', 'U', 'U', 'U', 'U', 'Y', 'B', 'Ss', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'c', 'e', 'e', 'e', 'e', 'i', 'i', 'i', 'i', 'o', 'n', 'o', 'o', 'o', 'o', 'o', 'o', 'u', 'u', 'u', 'y', 'b', 'y', 'R', 'r');
+
+ // Compute a new string
+ for(i in invalid)
+ string = string.replace(invalid[i], valid[i]);
+
+ return string;
+}
+
+// Encodes quotes in a string
+function encodeQuotes(str) {
+ return (str + '').replace(/"/g, '"');
+}
+
+// Gets the bare XID from a XID
+function bareXID(xid) {
+ // Cut the resource
+ xid = cutResource(xid);
+
+ // Launch the stringprep
+ xid = stringPrep(xid);
+
+ // Set the XID to lower case
+ xid = xid.toLowerCase();
+
+ return xid;
+}
+
+// Gets the full XID from a XID
+function fullXID(xid) {
+ // Normalizes the XID
+ var full = bareXID(xid);
+ var resource = thisResource(xid);
+
+ // Any resource?
+ if(resource)
+ full += '/' + resource;
+
+ return full;
+}
+
+// Gets the nick from a XID
+function getXIDNick(aXID) {
+ return explodeThis('@', aXID, 0);
+}
+
+// Gets the host from a XID
+function getXIDHost(aXID) {
+ return explodeThis('@', aXID, 1);
+}
+
+// Checks if we are in developer mode
+function isDeveloper() {
+ if(DEVELOPER == 'on')
+ return true;
+
+ return false;
+}
+
+// Checks if anonymous mode is allowed
+function allowedAnonymous() {
+ if(ANONYMOUS == 'on')
+ return true;
+
+ return false;
+}
+
+// Checks if host is locked
+function lockHost() {
+ if(LOCK_HOST == 'on')
+ return true;
+
+ return false;
+}
+
+// Gets the full XID of the user
+function getXID() {
+ // Return the XID of the user
+ if(con.username && con.domain)
+ return con.username + '@' + con.domain;
+
+ return '';
+}
+
+// Generates the colors for a given user XID
+function generateColor(xid) {
+ var colors = new Array(
+ 'ac0000',
+ 'a66200',
+ '007703',
+ '00705f',
+ '00236b',
+ '4e005c'
+ );
+
+ var number = 0;
+
+ for(var i = 0; i < xid.length; i++)
+ number += xid.charCodeAt(i);
+
+ var color = '#' + colors[number % (colors.length)];
+
+ return color;
+}
+
+// Checks if the XID is a gateway
+function isGateway(xid) {
+ if(xid.indexOf('@') != -1)
+ return false;
+
+ return true;
+}
+
+// Gets the from attribute of a stanza (overrides some servers like Prosody missing from attributes)
+function getStanzaFrom(stanza) {
+ var from = stanza.getFrom();
+
+ // No from, we assume this is our XID
+ if(!from)
+ from = getXID();
+
+ return from;
+}
+
+// Logs a given data in the console
+function logThis(data, level) {
+ // Console not available
+ if(!isDeveloper() || (typeof(console) == 'undefined'))
+ return false;
+
+ // Switch the log level
+ switch(level) {
+ // Debug
+ case 0:
+ console.debug(data);
+
+ break;
+
+ // Error
+ case 1:
+ console.error(data);
+
+ break;
+
+ // Warning
+ case 2:
+ console.warn(data);
+
+ break;
+
+ // Information
+ case 3:
+ console.info(data);
+
+ break;
+
+ // Default log level
+ default:
+ console.log(data);
+
+ break;
+ }
+
+ return true;
+}
+
+// Gets the current Jappix app. location
+function getJappixLocation() {
+ var url = window.location.href;
+
+ // If the URL has variables, remove them
+ if(url.indexOf('?') != -1)
+ url = url.split('?')[0];
+ if(url.indexOf('#') != -1)
+ url = url.split('#')[0];
+
+ // No "/" at the end
+ if(!url.match(/(.+)\/$/))
+ url += '/';
+
+ return url;
+}
+
+// Removes spaces at the beginning & the end of a string
+function trim(str) {
+ return str.replace(/^\s+/g,'').replace(/\s+$/g,'');
+}
+
+// Adds a zero to a date when needed
+function padZero(i) {
+ // Negative number (without first 0)
+ if(i > -10 && i < 0)
+ return '-0' + (i * -1);
+
+ // Positive number (without first 0)
+ if(i < 10 && i >= 0)
+ return '0' + i;
+
+ // All is okay
+ return i;
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/connection.js b/sources/extend/addon/matrix/jappixmini/jappix/js/connection.js
new file mode 100644
index 00000000..85a718c5
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/connection.js
@@ -0,0 +1,526 @@
+/*
+
+Jappix - An open social platform
+These are the connection JS script for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 29/08/11
+
+*/
+
+// Does the user login
+var CURRENT_SESSION = false;
+
+function doLogin(lNick, lServer, lPass, lResource, lPriority, lRemember) {
+ try {
+ // We remove the not completed class to avoid problems
+ $('#home .loginer input').removeClass('please-complete');
+
+ // We add the login wait div
+ showGeneralWait();
+
+ // We define the http binding parameters
+ oArgs = new Object();
+
+ if(HOST_BOSH_MAIN)
+ oArgs.httpbase = HOST_BOSH_MAIN;
+ else
+ oArgs.httpbase = HOST_BOSH;
+
+ // We create the new http-binding connection
+ con = new JSJaCHttpBindingConnection(oArgs);
+
+ // And we handle everything that happen
+ setupCon(con);
+
+ // Generate a resource
+ var random_resource = getDB('session', 'resource');
+
+ if(!random_resource)
+ random_resource = lResource + ' (' + (new Date()).getTime() + ')';
+
+ // We retrieve what the user typed in the login inputs
+ oArgs = new Object();
+ oArgs.domain = trim(lServer);
+ oArgs.username = trim(lNick);
+ oArgs.resource = random_resource;
+ oArgs.pass = lPass;
+ oArgs.secure = true;
+ oArgs.xmllang = XML_LANG;
+
+ // Store the resource (for reconnection)
+ setDB('session', 'resource', random_resource);
+
+ // Generate a session XML to be stored
+ session_xml = '' +
+ _e("You have been registered, here is your XMPP address:") + ' ' + con.username.htmlEnc() + '@' + con.domain.htmlEnc() + ' - ' + _e("Login") + '' +
+ '
'
+ );
+
+ // Login link
+ $('#home .homediv.registerer .success a').click(function() {
+ return doLogin(con.username, con.domain, con.pass, con.resource, '10', false);
+ });
+
+ // Show the waiting image
+ showGeneralWait();
+
+ // Change the page title
+ pageTitle('wait');
+ }
+
+ catch(e) {
+ // Logs errors
+ logThis(e, 1);
+ }
+
+ finally {
+ return false;
+ }
+}
+
+// Does the user anonymous login
+function doAnonymous() {
+ logThis('Trying to login anonymously...', 3);
+
+ var aPath = '#home .anonymouser ';
+ var room = $(aPath + '.room').val();
+ var nick = $(aPath + '.nick').val();
+
+ // If the form is correctly completed
+ if(room && nick) {
+ // We remove the not completed class to avoid problems
+ $('#home .anonymouser input').removeClass('please-complete');
+
+ // Redirect the user to the anonymous room
+ window.location.href = JAPPIX_LOCATION + '?r=' + room + '&n=' + nick;
+ }
+
+ // We check if the form is entirely completed
+ else {
+ $(aPath + 'input[type=text]').each(function() {
+ var select = $(this);
+
+ if(!select.val())
+ $(document).oneTime(10, function() {
+ select.addClass('please-complete').focus();
+ });
+ else
+ select.removeClass('please-complete');
+ });
+ }
+
+ return false;
+}
+
+// Handles the user connected event
+var CONNECTED = false;
+
+function handleConnected() {
+ logThis('Jappix is now connected.', 3);
+
+ // Connection markers
+ CONNECTED = true;
+ RECONNECT_TRY = 0;
+ RECONNECT_TIMER = 0;
+
+ // We hide the home page
+ $('#home').hide();
+
+ // Not resumed?
+ if(!RESUME) {
+ // Remember the session?
+ if(getDB('remember', 'session'))
+ setPersistent('session', 1, CURRENT_SESSION);
+
+ // We show the chatting app.
+ createTalkPage();
+
+ // We reset the homepage
+ switchHome('default');
+
+ // We get all the other things
+ getEverything();
+
+ // Set last activity stamp
+ LAST_ACTIVITY = getTimeStamp();
+ }
+
+ // Resumed
+ else {
+ // Send our presence
+ presenceSend();
+
+ // Change the title
+ updateTitle();
+ }
+
+ // Remove the waiting item
+ removeGeneralWait();
+}
+
+// Handles the user disconnected event
+function handleDisconnected() {
+ logThis('Jappix is now disconnected.', 3);
+
+ // Normal disconnection
+ if(!CURRENT_SESSION && !CONNECTED)
+ destroyTalkPage();
+}
+
+// Setups the normal connection
+function setupCon(con) {
+ // We setup all the necessary handlers for the connection
+ con.registerHandler('message', handleMessage);
+ con.registerHandler('presence', handlePresence);
+ con.registerHandler('iq', handleIQ);
+ con.registerHandler('onconnect', handleConnected);
+ con.registerHandler('onerror', handleError);
+ con.registerHandler('ondisconnect', handleDisconnected);
+}
+
+// Logouts from the server
+function logout() {
+ // We are not connected
+ if(!isConnected())
+ return false;
+
+ // Disconnect from the XMPP server
+ con.disconnect();
+
+ logThis('Jappix is disconnecting...', 3);
+}
+
+// Terminates a session
+function terminate() {
+ if(!isConnected())
+ return;
+
+ // Clear temporary session storage
+ resetConMarkers();
+
+ // Show the waiting item (useful if BOSH is sloooow)
+ showGeneralWait();
+
+ // Change the page title
+ pageTitle('wait');
+
+ // Disconnect from the XMPP server
+ logout();
+}
+
+// Quitss a session
+function quit() {
+ if(!isConnected())
+ return;
+
+ // We show the waiting image
+ showGeneralWait();
+
+ // Change the page title
+ pageTitle('wait');
+
+ // We disconnect from the XMPP server
+ logout();
+}
+
+// Creates the reconnect pane
+var RECONNECT_TRY = 0;
+var RECONNECT_TIMER = 0;
+
+function createReconnect(mode) {
+ logThis('This is not a normal disconnection, show the reconnect pane...', 1);
+
+ // Reconnect pane not yet displayed?
+ if(!exists('#reconnect')) {
+ // Blur the focused input/textarea/select
+ $('input, select, textarea').blur();
+
+ // Create the HTML code
+ var html = '' +
+ '
';
+
+ // Append the code
+ $('body').append(html);
+
+ // Click events
+ if(mode == 'normal')
+ $('#reconnect a.finish.cancel').click(function() {
+ return cancelReconnect();
+ });
+
+ $('#reconnect a.finish.reconnect').click(function() {
+ return acceptReconnect(mode);
+ });
+
+ // Try to reconnect automatically after a while
+ if(RECONNECT_TRY < 5)
+ RECONNECT_TIMER = 5 + (5 * RECONNECT_TRY);
+ else
+ RECONNECT_TIMER = 120;
+
+ // Change the try number
+ RECONNECT_TRY++;
+
+ // Fire the event!
+ $('#reconnect a.finish.reconnect').everyTime('1s', function() {
+ // We can reconnect!
+ if(RECONNECT_TIMER == 0)
+ return acceptReconnect(mode);
+
+ // Button text
+ if(RECONNECT_TIMER <= 10)
+ $(this).text(_e("Reconnect") + ' (' + RECONNECT_TIMER + ')');
+
+ // Remove 1 second
+ RECONNECT_TIMER--;
+ });
+
+ // Page title
+ updateTitle();
+ }
+}
+
+// Reconnects the user if he was disconnected (network issue)
+var RESUME = false;
+
+function acceptReconnect(mode) {
+ logThis('Trying to reconnect the user...', 3);
+
+ // Resume marker
+ RESUME = true;
+
+ // Show waiting item
+ showGeneralWait();
+
+ // Reset some various stuffs
+ var groupchats = '#page-engine .page-engine-chan[data-type=groupchat]';
+ $(groupchats + ' .list .role').hide();
+ $(groupchats + ' .one-group, ' + groupchats + ' .list .user').remove();
+ $(groupchats).attr('data-initial', 'false');
+
+ // Stop the timer
+ $('#reconnect a.finish.reconnect').stopTime();
+
+ // Remove the reconnect pane
+ $('#reconnect').remove();
+
+ // Try to login again
+ if(mode == 'normal')
+ loginFromSession(XMLFromString(CURRENT_SESSION));
+ else if(mode == 'anonymous')
+ anonymousLogin(HOST_ANONYMOUS);
+
+ return false;
+}
+
+// Cancel the reconnection of user account (network issue)
+function cancelReconnect() {
+ logThis('User has canceled automatic reconnection...', 3);
+
+ // Stop the timer
+ $('#reconnect a.finish.reconnect').stopTime();
+
+ // Remove the reconnect pane
+ $('#reconnect').remove();
+
+ // Destroy the talk page
+ destroyTalkPage();
+
+ // Renitialize the previous session parameters
+ resetConMarkers();
+
+ return false;
+}
+
+// Clears session reminder database
+function clearLastSession() {
+ // Clear temporary storage
+ resetConMarkers();
+
+ // Clear persistent storage
+ if($(XMLFromString(getPersistent('session', 1))).find('stored').text() == 'true')
+ removePersistent('session', 1);
+}
+
+// Resets the connection markers
+function resetConMarkers() {
+ CURRENT_SESSION = false;
+ CONNECTED = false;
+ RESUME = false;
+ RECONNECT_TRY = 0;
+ RECONNECT_TIMER = 0;
+}
+
+// Logins from a saved session
+function loginFromSession(data) {
+ // Select the data
+ var session = $(data);
+
+ // Fire the login event
+ doLogin(
+ session.find('username').text(),
+ session.find('domain').text(),
+ session.find('password').text(),
+ session.find('resource').text(),
+ session.find('priority').text(),
+ false
+ );
+}
+
+// Quits a session normally
+function normalQuit() {
+ // Reset our database
+ clearLastSession();
+
+ // We quit the current session
+ quit();
+
+ // We show an info
+ openThisInfo(3);
+
+ return false;
+}
+
+// Gets all the users stuffs
+function getEverything() {
+ getFeatures();
+ getRoster();
+ listPrivacy();
+ getStorage(NS_ROSTERNOTES);
+}
+
+// Plugin launcher
+function launchConnection() {
+ // Logouts when Jappix is closed
+ $(window).bind('beforeunload', terminate);
+
+ // Nothing to do when anonymous!
+ if(isAnonymous())
+ return;
+
+ // Try to resume a stored session, if not anonymous
+ var session = XMLFromString(getPersistent('session', 1));
+
+ if($(session).find('stored').text() == 'true') {
+ // Hide the homepage
+ $('#home').hide();
+
+ // Show the waiting icon
+ showGeneralWait();
+
+ // Login!
+ loginFromSession(session);
+
+ logThis('Saved session found, resuming it...', 3);
+ }
+
+ // Not connected, maybe a XMPP link is submitted?
+ else if((parent.location.hash != '#OK') && LINK_VARS['x']) {
+ switchHome('loginer');
+
+ logThis('A XMPP link is set, switch to login page.', 3);
+ }
+}
+
+// Launch this plugin!
+$(document).ready(launchConnection);
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/constants.js b/sources/extend/addon/matrix/jappixmini/jappix/js/constants.js
new file mode 100644
index 00000000..bc59bd75
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/constants.js
@@ -0,0 +1,211 @@
+/*
+
+Jappix - An open social platform
+These are the constants JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Authors: Stefan Strigler, Vanaryon
+Last revision: 26/08/11
+
+*/
+
+// XMPP XMLNS attributes
+var NS_PROTOCOL = 'http://jabber.org/protocol/';
+var NS_FEATURES = 'http://jabber.org/features/';
+var NS_CLIENT = 'jabber:client';
+var NS_IQ = 'jabber:iq:';
+var NS_X = 'jabber:x:';
+var NS_IETF = 'urn:ietf:params:xml:ns:xmpp-';
+var NS_XMPP = 'urn:xmpp:';
+
+var NS_STORAGE = 'storage:';
+var NS_BOOKMARKS = NS_STORAGE + 'bookmarks';
+var NS_ROSTERNOTES = NS_STORAGE + 'rosternotes';
+
+var NS_JAPPIX = 'jappix:';
+var NS_INBOX = NS_JAPPIX + 'inbox';
+var NS_OPTIONS = NS_JAPPIX + 'options';
+
+var NS_DISCO_ITEMS = NS_PROTOCOL + 'disco#items';
+var NS_DISCO_INFO = NS_PROTOCOL + 'disco#info';
+var NS_VCARD = 'vcard-temp';
+var NS_VCARD_P = NS_VCARD + ':x:update';
+var NS_AUTH = NS_IQ + 'auth';
+var NS_AUTH_ERROR = NS_IQ + 'auth:error';
+var NS_REGISTER = NS_IQ + 'register';
+var NS_SEARCH = NS_IQ + 'search';
+var NS_ROSTER = NS_IQ + 'roster';
+var NS_PRIVACY = NS_IQ + 'privacy';
+var NS_PRIVATE = NS_IQ + 'private';
+var NS_VERSION = NS_IQ + 'version';
+var NS_TIME = NS_IQ + 'time';
+var NS_LAST = NS_IQ + 'last';
+var NS_IQDATA = NS_IQ + 'data';
+var NS_XDATA = NS_X + 'data';
+var NS_IQOOB = NS_IQ + 'oob';
+var NS_XOOB = NS_X + 'oob';
+var NS_DELAY = NS_X + 'delay';
+var NS_EXPIRE = NS_X + 'expire';
+var NS_EVENT = NS_X + 'event';
+var NS_XCONFERENCE = NS_X + 'conference';
+var NS_STATS = NS_PROTOCOL + 'stats';
+var NS_MUC = NS_PROTOCOL + 'muc';
+var NS_MUC_USER = NS_MUC + '#user';
+var NS_MUC_ADMIN = NS_MUC + '#admin';
+var NS_MUC_OWNER = NS_MUC + '#owner';
+var NS_MUC_CONFIG = NS_MUC + '#roomconfig';
+var NS_PUBSUB = NS_PROTOCOL + 'pubsub';
+var NS_PUBSUB_EVENT = NS_PUBSUB + '#event';
+var NS_PUBSUB_OWNER = NS_PUBSUB + '#owner';
+var NS_PUBSUB_NMI = NS_PUBSUB + '#node-meta-info';
+var NS_PUBSUB_NC = NS_PUBSUB + '#node_config';
+var NS_PUBSUB_RI = NS_PUBSUB + '#retrieve-items';
+var NS_COMMANDS = NS_PROTOCOL + 'commands';
+var NS_BOSH = NS_PROTOCOL + 'httpbind';
+var NS_STREAM = 'http://etherx.jabber.org/streams';
+var NS_URN_TIME = NS_XMPP + 'time';
+var NS_URN_PING = NS_XMPP + 'ping';
+var NS_URN_ADATA = NS_XMPP + 'avatar:data';
+var NS_URN_AMETA = NS_XMPP + 'avatar:metadata';
+var NS_URN_MBLOG = NS_XMPP + 'microblog:0';
+var NS_URN_INBOX = NS_XMPP + 'inbox';
+var NS_URN_ARCHIVE = NS_XMPP + 'archive';
+var NS_URN_AR_PREF = NS_URN_ARCHIVE + ':pref';
+var NS_URN_AR_AUTO = NS_URN_ARCHIVE + ':auto';
+var NS_URN_AR_MANUAL = NS_URN_ARCHIVE + ':manual';
+var NS_URN_AR_MANAGE = NS_URN_ARCHIVE + ':manage';
+var NS_URN_DELAY = NS_XMPP + 'delay';
+var NS_URN_RECEIPTS = NS_XMPP + 'receipts';
+var NS_RSM = NS_PROTOCOL + 'rsm';
+var NS_IPV6 = 'ipv6';
+var NS_XHTML = 'http://www.w3.org/1999/xhtml';
+var NS_XHTML_IM = NS_PROTOCOL + 'xhtml-im';
+var NS_CHATSTATES = NS_PROTOCOL + 'chatstates';
+var NS_HTTP_AUTH = NS_PROTOCOL + 'http-auth';
+var NS_ROSTERX = NS_PROTOCOL + 'rosterx';
+var NS_MOOD = NS_PROTOCOL + 'mood';
+var NS_ACTIVITY = NS_PROTOCOL + 'activity';
+var NS_TUNE = NS_PROTOCOL + 'tune';
+var NS_GEOLOC = NS_PROTOCOL + 'geoloc';
+var NS_NICK = NS_PROTOCOL + 'nick';
+var NS_NOTIFY = '+notify';
+var NS_CAPS = NS_PROTOCOL + 'caps';
+var NS_ATOM = 'http://www.w3.org/2005/Atom';
+
+var NS_STANZAS = NS_IETF + 'stanzas';
+var NS_STREAMS = NS_IETF + 'streams';
+
+var NS_TLS = NS_IETF + 'tls';
+var NS_SASL = NS_IETF + 'sasl';
+var NS_SESSION = NS_IETF + 'session';
+var NS_BIND = NS_IETF + 'bind';
+
+var NS_FEATURE_IQAUTH = NS_FEATURES + 'iq-auth';
+var NS_FEATURE_IQREGISTER = NS_FEATURES + 'iq-register';
+var NS_FEATURE_COMPRESS = NS_FEATURES + 'compress';
+
+var NS_COMPRESS = NS_PROTOCOL + 'compress';
+
+// Available locales
+var LOCALES_AVAILABLE_ID = new Array();
+var LOCALES_AVAILABLE_NAMES = new Array();
+
+// XML lang
+var XML_LANG = null;
+
+// Jappix parameters
+var JAPPIX_STATIC = null;
+var JAPPIX_VERSION = null;
+var JAPPIX_MAX_FILE_SIZE = null;
+var JAPPIX_MAX_UPLOAD = null;
+
+// Jappix main configuration
+var SERVICE_NAME = null;
+var SERVICE_DESC = null;
+var JAPPIX_RESOURCE = null;
+var LOCK_HOST = null;
+var ANONYMOUS = null;
+var REGISTRATION = null;
+var BOSH_PROXY = null;
+var MANAGER_LINK = null;
+var GROUPCHATS_JOIN = null;
+var ENCRYPTION = null;
+var HTTPS_STORAGE = null;
+var HTTPS_FORCE = null;
+var COMPRESSION = null;
+var MULTI_FILES = null;
+var DEVELOPER = null;
+
+// Jappix hosts configuration
+var HOST_MAIN = null;
+var HOST_MUC = null;
+var HOST_PUBSUB = null;
+var HOST_VJUD = null;
+var HOST_ANONYMOUS = null;
+var HOST_BOSH = null;
+var HOST_BOSH_MAIN = null;
+var HOST_BOSH_MINI = null;
+var HOST_STATIC = null;
+var HOST_UPLOAD = null;
+
+// Anonymous mode
+var ANONYMOUS_ROOM = null;
+var ANONYMOUS_NICK = null;
+
+// Node parameters
+var JAPPIX_LOCATION = getJappixLocation();
+
+// XMPP error stanzas
+function STANZA_ERROR(code, type, cond) {
+ if (window == this)
+ return new STANZA_ERROR(code, type, cond);
+
+ this.code = code;
+ this.type = type;
+ this.cond = cond;
+}
+
+var ERR_BAD_REQUEST =
+ STANZA_ERROR('400', 'modify', 'bad-request');
+var ERR_CONFLICT =
+ STANZA_ERROR('409', 'cancel', 'conflict');
+var ERR_FEATURE_NOT_IMPLEMENTED =
+ STANZA_ERROR('501', 'cancel', 'feature-not-implemented');
+var ERR_FORBIDDEN =
+ STANZA_ERROR('403', 'auth', 'forbidden');
+var ERR_GONE =
+ STANZA_ERROR('302', 'modify', 'gone');
+var ERR_INTERNAL_SERVER_ERROR =
+ STANZA_ERROR('500', 'wait', 'internal-server-error');
+var ERR_ITEM_NOT_FOUND =
+ STANZA_ERROR('404', 'cancel', 'item-not-found');
+var ERR_JID_MALFORMED =
+ STANZA_ERROR('400', 'modify', 'jid-malformed');
+var ERR_NOT_ACCEPTABLE =
+ STANZA_ERROR('406', 'modify', 'not-acceptable');
+var ERR_NOT_ALLOWED =
+ STANZA_ERROR('405', 'cancel', 'not-allowed');
+var ERR_NOT_AUTHORIZED =
+ STANZA_ERROR('401', 'auth', 'not-authorized');
+var ERR_PAYMENT_REQUIRED =
+ STANZA_ERROR('402', 'auth', 'payment-required');
+var ERR_RECIPIENT_UNAVAILABLE =
+ STANZA_ERROR('404', 'wait', 'recipient-unavailable');
+var ERR_REDIRECT =
+ STANZA_ERROR('302', 'modify', 'redirect');
+var ERR_REGISTRATION_REQUIRED =
+ STANZA_ERROR('407', 'auth', 'registration-required');
+var ERR_REMOTE_SERVER_NOT_FOUND =
+ STANZA_ERROR('404', 'cancel', 'remote-server-not-found');
+var ERR_REMOTE_SERVER_TIMEOUT =
+ STANZA_ERROR('504', 'wait', 'remote-server-timeout');
+var ERR_RESOURCE_CONSTRAINT =
+ STANZA_ERROR('500', 'wait', 'resource-constraint');
+var ERR_SERVICE_UNAVAILABLE =
+ STANZA_ERROR('503', 'cancel', 'service-unavailable');
+var ERR_SUBSCRIPTION_REQUIRED =
+ STANZA_ERROR('407', 'auth', 'subscription-required');
+var ERR_UNEXPECTED_REQUEST =
+ STANZA_ERROR('400', 'wait', 'unexpected-request');
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/dataform.js b/sources/extend/addon/matrix/jappixmini/jappix/js/dataform.js
new file mode 100644
index 00000000..7fbea89d
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/dataform.js
@@ -0,0 +1,921 @@
+/*
+
+Jappix - An open social platform
+These are the dataform JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 28/08/11
+
+*/
+
+// Gets the defined dataform elements
+function dataForm(host, type, node, action, target) {
+ // Clean the current session
+ cleanDataForm(target);
+
+ // We tell the user that a search has been launched
+ $('#' + target + ' .wait').show();
+
+ // If we have enough data
+ if(host && type) {
+ // Generate a session ID
+ var sessionID = Math.round(100000.5 + (((900000.49999) - (100000.5)) * Math.random()));
+ var id = target + '-' + sessionID + '-' + genID();
+ $('.' + target + '-results').attr('data-session', target + '-' + sessionID);
+
+ // We request the service item
+ var iq = new JSJaCIQ();
+ iq.setID(id);
+ iq.setTo(host);
+ iq.setType('get');
+
+ // MUC admin query
+ if(type == 'muc') {
+ iq.setQuery(NS_MUC_OWNER);
+ con.send(iq, handleDataFormMuc);
+ }
+
+ // Browse query
+ else if(type == 'browse') {
+ var iqQuery = iq.setQuery(NS_DISCO_ITEMS);
+
+ if(node)
+ iqQuery.setAttribute('node', node);
+
+ con.send(iq, handleDataFormBrowse);
+ }
+
+ // Command
+ else if(type == 'command') {
+ var items;
+
+ if(node)
+ items = iq.appendNode('command', {'node': node, 'xmlns': NS_COMMANDS});
+
+ else {
+ items = iq.setQuery(NS_DISCO_ITEMS);
+ items.setAttribute('node', NS_COMMANDS);
+ }
+
+ if(action && node) {
+ iq.setType('set');
+ items.setAttribute('action', action);
+ }
+
+ con.send(iq, handleDataFormCommand);
+ }
+
+ // Search query
+ else if(type == 'search') {
+ iq.setQuery(NS_SEARCH);
+ con.send(iq, handleDataFormSearch);
+ }
+
+ // Subscribe query
+ else if(type == 'subscribe') {
+ iq.setQuery(NS_REGISTER);
+ con.send(iq, handleDataFormSubscribe);
+ }
+
+ // Join
+ else if(type == 'join') {
+ if(target == 'discovery')
+ closeDiscovery();
+
+ checkChatCreate(host, 'groupchat');
+ }
+ }
+
+ return false;
+}
+
+// Sends a given dataform
+function sendDataForm(type, action, x_type, id, xid, node, sessionid, target) {
+ // Path
+ var pathID = '#' + target + ' .results[data-session=' + id + ']';
+
+ // New IQ
+ var iq = new JSJaCIQ();
+ iq.setTo(xid);
+ iq.setType('set');
+
+ // Set the correct query
+ var query;
+
+ if(type == 'subscribe')
+ iqQuery = iq.setQuery(NS_REGISTER);
+ else if(type == 'search')
+ iqQuery = iq.setQuery(NS_SEARCH);
+ else if(type == 'command')
+ iqQuery = iq.appendNode('command', {'xmlns': NS_COMMANDS, 'node': node, 'sessionid': sessionid, 'action': action});
+ else if(type == 'x')
+ iqQuery = iq.setQuery(NS_MUC_OWNER);
+
+ // Build the XML document
+ if(action != 'cancel') {
+ // No X node
+ if(exists('input.register-special') && (type == 'subscribe')) {
+ $('input.register-special').each(function() {
+ var iName = $(this).attr('name');
+ var iValue = $(this).val();
+
+ iqQuery.appendChild(iq.buildNode(iName, {'xmlns': NS_REGISTER}, iValue));
+ });
+ }
+
+ // Can create the X node
+ else {
+ var iqX = iqQuery.appendChild(iq.buildNode('x', {'xmlns': NS_XDATA, 'type': x_type}));
+
+ // Each input
+ $(pathID + ' .oneresult input, ' + pathID + ' .oneresult textarea, ' + pathID + ' .oneresult select').each(function() {
+ // Get the current input value
+ var iVar = $(this).attr('name');
+ var iType = $(this).attr('data-type');
+ var iValue = $(this).val();
+
+ // Build a new field node
+ var field = iqX.appendChild(iq.buildNode('field', {'var': iVar, 'type': iType, 'xmlns': NS_XDATA}));
+
+ // Boolean input?
+ if(iType == 'boolean') {
+ if($(this).filter(':checked').size())
+ iValue = '1';
+ else
+ iValue = '0';
+ }
+
+ // JID-multi input?
+ if(iType == 'jid-multi') {
+ // Values array
+ var xid_arr = [iValue];
+ var xid_check = [];
+
+ // Try to split it
+ if(iValue.indexOf(',') != -1)
+ xid_arr = iValue.split(',');
+
+ // Append each value to the XML document
+ for(i in xid_arr) {
+ // Get the current value
+ xid_current = trim(xid_arr[i]);
+
+ // No current value?
+ if(!xid_current)
+ continue;
+
+ // Add the current value
+ if(!existArrayValue(xid_check, xid_current)) {
+ xid_check.push(xid_current);
+ field.appendChild(iq.buildNode('value', {'xmlns': NS_XDATA}, xid_current));
+ }
+ }
+ }
+
+ // List-multi selector?
+ else if(iType == 'list-multi') {
+ // Any value?
+ if(iValue && iValue.length) {
+ for(i in iValue)
+ field.appendChild(iq.buildNode('value', {'xmlns': NS_XDATA}, iValue[i]));
+ }
+ }
+
+ // Other inputs?
+ else
+ field.appendChild(iq.buildNode('value', {'xmlns': NS_XDATA}, iValue));
+ });
+ }
+ }
+
+ // Clean the current session
+ cleanDataForm(target);
+
+ // Show the waiting item
+ $('#' + target + ' .wait').show();
+
+ // Change the ID of the current discovered item
+ var iqID = target + '-' + genID();
+ $('#' + target + ' .' + target + '-results').attr('data-session', iqID);
+ iq.setID(iqID);
+
+ // Send the IQ
+ if(type == 'subscribe')
+ con.send(iq, handleDataFormSubscribe);
+ else if(type == 'search')
+ con.send(iq, handleDataFormSearch);
+ else if(type == 'command')
+ con.send(iq, handleDataFormCommand);
+ else
+ con.send(iq);
+
+ return false;
+}
+
+// Displays the good dataform buttons
+function buttonsDataForm(type, action, id, xid, node, sessionid, target, pathID) {
+ // No need to use buttons?
+ if(type == 'muc')
+ return;
+
+ // Override the "undefined" output
+ if(!id)
+ id = '';
+ if(!xid)
+ xid = '';
+ if(!node)
+ node = '';
+ if(!sessionid)
+ sessionid = '';
+
+ // We generate the buttons code
+ var buttonsCode = '' +
+ _e("Due to a network issue, you were disconnected. What do you want to do now?");
+
+ // Can we cancel reconnection?
+ if(mode == 'normal')
+ html += '' + _e("Cancel") + '';
+
+ html += '' + _e("Reconnect") + '' +
+ '
';
+
+ if(action == 'submit') {
+ if((target == 'adhoc') && (type == 'command')) {
+ buttonsCode += '' + _e("Submit") + '';
+
+ // When keyup on one text input
+ $(pathID + ' input').keyup(function(e) {
+ if(e.keyCode == 13) {
+ sendDataForm(type, 'execute', 'submit', id, xid, node, sessionid, target);
+
+ return false;
+ }
+ });
+ }
+
+ else {
+ buttonsCode += '' + _e("Submit") + '';
+
+ // When keyup on one text input
+ $(pathID + ' input').keyup(function(e) {
+ if(e.keyCode == 13) {
+ sendDataForm(type, 'submit', 'submit', id, xid, node, sessionid, target);
+
+ return false;
+ }
+ });
+ }
+ }
+
+ if((action == 'submit') && (type != 'subscribe') && (type != 'search'))
+ buttonsCode += '' + _e("Cancel") + '';
+
+ if(((action == 'back') || (type == 'subscribe') || (type == 'search')) && (target == 'discovery'))
+ buttonsCode += '' + _e("Close") + '';
+
+ if((action == 'back') && ((target == 'welcome') || (target == 'directory')))
+ buttonsCode += '' + _e("Previous") + '';
+
+ if((action == 'back') && (target == 'adhoc'))
+ buttonsCode += '' + _e("Previous") + '';
+
+ buttonsCode += '
';
+
+ // We display the buttons code
+ $(pathID).append(buttonsCode);
+
+ // If no submit link, lock the form
+ if(!exists(pathID + ' a.submit'))
+ $(pathID + ' input, ' + pathID + ' textarea').attr('readonly', true);
+}
+
+// Handles the MUC dataform
+function handleDataFormMuc(iq) {
+ handleErrorReply(iq);
+ handleDataFormContent(iq, 'muc');
+}
+
+// Handles the browse dataform
+function handleDataFormBrowse(iq) {
+ handleErrorReply(iq);
+ handleDataFormContent(iq, 'browse');
+}
+
+// Handles the command dataform
+function handleDataFormCommand(iq) {
+ handleErrorReply(iq);
+ handleDataFormContent(iq, 'command');
+}
+
+// Handles the subscribe dataform
+function handleDataFormSubscribe(iq) {
+ handleErrorReply(iq);
+ handleDataFormContent(iq, 'subscribe');
+}
+
+// Handles the search dataform
+function handleDataFormSearch(iq) {
+ handleErrorReply(iq);
+ handleDataFormContent(iq, 'search');
+}
+
+// Handles the dataform content
+function handleDataFormContent(iq, type) {
+ // Get the ID
+ var sID = iq.getID();
+
+ // Get the target
+ var splitted = sID.split('-');
+ var target = splitted[0];
+ var sessionID = target + '-' + splitted[1];
+ var from = fullXID(getStanzaFrom(iq));
+ var pathID = '#' + target + ' .results[data-session=' + sessionID + ']';
+
+ // If an error occured
+ if(!iq || (iq.getType() != 'result'))
+ noResultDataForm(pathID);
+
+ // If we got something okay
+ else {
+ var handleXML = iq.getNode();
+
+ if(type == 'browse') {
+ if($(handleXML).find('item').attr('jid')) {
+ // Get the query node
+ var queryNode = $(handleXML).find('query').attr('node');
+
+ $(handleXML).find('item').each(function() {
+ // We parse the received xml
+ var itemHost = $(this).attr('jid');
+ var itemNode = $(this).attr('node');
+ var itemName = $(this).attr('name');
+ var itemHash = hex_md5(itemHost);
+
+ // Node
+ if(itemNode)
+ $(pathID).append(
+ '' +
+ '
'
+ );
+
+ // Item
+ else if(queryNode && itemName)
+ $(pathID).append(
+ '' + itemNode.htmlEnc() + '
' +
+ '' +
+ '
'
+ );
+
+ // Item with children
+ else {
+ // We display the waiting element
+ $(pathID + ' .disco-wait .disco-category-title').after(
+ '' + itemName.htmlEnc() + '
' +
+ '' +
+ '' +
+ '
'
+ );
+
+ // We display the category
+ $('#' + target + ' .disco-wait').show();
+
+ // We ask the server what's the service type
+ getDataFormType(itemHost, itemNode, sessionID);
+ }
+ });
+ }
+
+ // Else, there are no items for this query
+ else
+ noResultDataForm(pathID);
+ }
+
+ else if((type == 'muc') || (type == 'search') || (type == 'subscribe') || ((type == 'command') && $(handleXML).find('command').attr('xmlns'))) {
+ // Get some values
+ var xCommand = $(handleXML).find('command');
+ var bNode = xCommand.attr('node');
+ var bSession = xCommand.attr('sessionid');
+ var bStatus = xCommand.attr('status');
+ var xRegister = $(handleXML).find('query[xmlns=' + NS_REGISTER + ']').text();
+ var xElement = $(handleXML).find('x');
+
+ // Search done
+ if((xElement.attr('type') == 'result') && (type == 'search')) {
+ var bPath = pathID;
+
+ // Display the result
+ $(handleXML).find('item').each(function() {
+ var bXID = $(this).find('field[var=jid] value:first').text();
+ var bName = $(this).find('field[var=fn] value:first').text();
+ var bCountry = $(this).find('field[var=ctry] value:first').text();
+ var dName = bName;
+
+ // Override "undefined" value
+ if(!bXID)
+ bXID = '';
+ if(!bName)
+ bName = _e("Unknown name");
+ if(!bCountry)
+ bCountry = _e("Unknown country");
+
+ // User hash
+ var bHash = hex_md5(bXID);
+
+ // HTML code
+ var bHTML = '' + itemHost + '
' +
+ '' + _e("Requesting this service...") + '
' +
+ '' +
+ '
';
+
+ $(bPath).append(bHTML);
+
+ // Click events
+ $(bPath + ' .' + bHash + ' a').click(function() {
+ // Buddy add
+ if($(this).is('.one-add')) {
+ $(this).hide();
+
+ addThisContact(bXID, dName);
+ }
+
+ // Buddy chat
+ if($(this).is('.one-chat')) {
+ if(target == 'discovery')
+ closeDiscovery();
+
+ checkChatCreate(bXID , 'chat', '', '', dName);
+ }
+
+ return false;
+ });
+
+ // Get the user's avatar
+ if(bXID)
+ getAvatar(bXID, 'cache', 'true', 'forget');
+ });
+
+ // No result?
+ if(!$(handleXML).find('item').size())
+ noResultDataForm(pathID);
+
+ // Previous button
+ buttonsDataForm(type, 'back', sessionID, from, bNode, bSession, target, pathID);
+ }
+
+ // Command to complete
+ else if(xElement.attr('xmlns') || ((type == 'subscribe') && xRegister)) {
+ // We display the elements
+ fillDataForm(handleXML, sessionID);
+
+ // We display the buttons
+ if(bStatus != 'completed')
+ buttonsDataForm(type, 'submit', sessionID, from, bNode, bSession, target, pathID);
+ else
+ buttonsDataForm(type, 'back', sessionID, from, bNode, bSession, target, pathID);
+ }
+
+ // Command completed or subscription done
+ else if(((bStatus == 'completed') && (type == 'command')) || (!xRegister && (type == 'subscribe'))) {
+ // Display the good text
+ var cNote = $(xCommand).find('note');
+
+ // Any note?
+ if(cNote.size()) {
+ cNote.each(function() {
+ $(pathID).append(
+ '' +
+ '' +
+ '
' +
+ '' +
+ '' + bName + '
' +
+ '' + bCountry + '
' +
+ '' + bXID + '
' +
+ '' + $(this).text().htmlEnc() + '
'
+ );
+ });
+ }
+
+ // Default text
+ else
+ $(pathID).append('' + _e("Your form has been sent.") + '
');
+
+ // Display the back button
+ buttonsDataForm(type, 'back', sessionID, from, '', '', target, pathID);
+
+ // Add the gateway to our roster if subscribed
+ if(type == 'subscribe')
+ addThisContact(from);
+ }
+
+ // Command canceled
+ else if((bStatus == 'canceled') && (type == 'command')) {
+ if(target == 'discovery')
+ startDiscovery();
+ else if(target == 'adhoc')
+ dataForm(from, 'command', '', '', 'adhoc');
+ }
+
+ // No items for this query
+ else
+ noResultDataForm(pathID);
+ }
+
+ else if(type == 'command') {
+ if($(handleXML).find('item').attr('jid')) {
+ // We display the elements
+ $(handleXML).find('item').each(function() {
+ // We parse the received xml
+ var itemHost = $(this).attr('jid');
+ var itemNode = $(this).attr('node');
+ var itemName = $(this).attr('name');
+ var itemHash = hex_md5(itemHost);
+
+ // We display the waiting element
+ $(pathID).prepend(
+ '' +
+ '
'
+ );
+ });
+ }
+
+ // Else, there are no items for this query
+ else
+ noResultDataForm(pathID);
+ }
+ }
+
+ // Focus on the first input
+ $(document).oneTime(10, function() {
+ $(pathID + ' input:visible:first').focus();
+ });
+
+ // Hide the wait icon
+ $('#' + target + ' .wait').hide();
+}
+
+// Fills the dataform elements
+function fillDataForm(xml, id) {
+ /* REF: http://xmpp.org/extensions/xep-0004.html */
+
+ // Initialize new vars
+ var target = id.split('-')[0];
+ var pathID = '#' + target + ' .results[data-session=' + id + ']';
+ var selector, is_dataform;
+
+ // Is it a dataform?
+ if($(xml).find('x[xmlns=' + NS_XDATA + ']').size())
+ is_dataform = true;
+ else
+ is_dataform = false;
+
+ // Determines the good selector to use
+ if(is_dataform)
+ selector = $(xml).find('x[xmlns=' + NS_XDATA + ']');
+ else
+ selector = $(xml);
+
+ // Form title
+ selector.find('title').each(function() {
+ $(pathID).append(
+ '' + itemName + '
' +
+ '»
' +
+ '' + $(this).text().htmlEnc() + '
'
+ );
+ });
+
+ // Form instructions
+ selector.find('instructions').each(function() {
+ $(pathID).append(
+ '' + $(this).text().htmlEnc() + '
'
+ );
+ });
+
+ // Register?
+ if(!is_dataform) {
+ // Items to detect
+ var reg_names = [_e("Nickname"), _e("Name"), _e("Password"), _e("E-mail")];
+ var reg_ids = ['username', 'name', 'password', 'email'];
+
+ // Append these inputs
+ for(a in reg_names) {
+ selector.find(reg_ids[a]).each(function() {
+ $(pathID).append(
+ '' +
+ '' +
+ '' +
+ '
'
+ );
+ });
+ }
+
+ return false;
+ }
+
+ // Dataform?
+ selector.find('field').each(function() {
+ // We parse the received xml
+ var type = $(this).attr('type');
+ var label = $(this).attr('label');
+ var field = $(this).attr('var');
+ var value = $(this).find('value:first').text();
+ var required = '';
+
+ // No value?
+ if(!field)
+ return;
+
+ // Required input?
+ if($(this).find('required').size())
+ required = ' required=""';
+
+ // Compatibility fix
+ if(!label)
+ label = field;
+
+ if(!type)
+ type = '';
+
+ // Generate some values
+ var input;
+ var hideThis = '';
+
+ // Fixed field
+ if(type == 'fixed')
+ $(pathID).append('' + value.htmlEnc() + '
');
+
+ else {
+ // Hidden field
+ if(type == 'hidden') {
+ hideThis = ' style="display: none;"';
+ input = '';
+ }
+
+ // Boolean field
+ else if(type == 'boolean') {
+ var checked;
+
+ if(value == '1')
+ checked = 'checked';
+ else
+ checked = '';
+
+ input = '';
+ }
+
+ // List-single/list-multi field
+ else if((type == 'list-single') || (type == 'list-multi')) {
+ var multiple = '';
+
+ // Multiple options?
+ if(type == 'list-multi')
+ multiple = ' multiple=""';
+
+ // Append the select field
+ input = '';
+ }
+
+ // Text-multi field
+ else if(type == 'text-multi')
+ input = '';
+
+ // JID-multi field
+ else if(type == 'jid-multi') {
+ // Put the XID into an array
+ var xid_arr = [];
+
+ $(this).find('value').each(function() {
+ var cValue = $(this).text();
+
+ if(!existArrayValue(xid_arr, cValue))
+ xid_arr.push(cValue);
+ });
+
+ // Sort the array
+ xid_arr.sort();
+
+ // Create the input
+ var xid_value = '';
+
+ if(xid_arr.length) {
+ for(i in xid_arr) {
+ // Any pre-value
+ if(xid_value)
+ xid_value += ', ';
+
+ // Add the current XID
+ xid_value += xid_arr[i];
+ }
+ }
+
+ input = '';
+ }
+
+ // Other stuffs that are similar
+ else {
+ // Text-single field
+ var iType = 'text';
+
+ // Text-private field
+ if(type == 'text-private')
+ iType = 'password';
+
+ // JID-single field
+ else if(type == 'jid-single')
+ iType = 'email';
+
+ input = '';
+ }
+
+ // Append the HTML markup for this field
+ $(pathID).append(
+ '' +
+ '' +
+ input +
+ '
'
+ );
+ }
+ });
+
+ return false;
+}
+
+// Gets the dataform type
+function getDataFormType(host, node, id) {
+ var iq = new JSJaCIQ();
+ iq.setID(id + '-' + genID());
+ iq.setTo(host);
+ iq.setType('get');
+
+ var iqQuery = iq.setQuery(NS_DISCO_INFO);
+
+ if(node)
+ iqQuery.setAttribute('node', node);
+
+ con.send(iq, handleThisBrowse);
+}
+
+// Handles the browse stanza
+function handleThisBrowse(iq) {
+ /* REF: http://xmpp.org/registrar/disco-categories.html */
+
+ var id = iq.getID();
+ var splitted = id.split('-');
+ var target = splitted[0];
+ var sessionID = target + '-' + splitted[1];
+ var from = fullXID(getStanzaFrom(iq));
+ var hash = hex_md5(from);
+ var handleXML = iq.getQuery();
+ var pathID = '#' + target + ' .results[data-session=' + sessionID + ']';
+
+ // We first remove the waiting element
+ $(pathID + ' .disco-wait .' + hash).remove();
+
+ if($(handleXML).find('identity').attr('type')) {
+ var category = $(handleXML).find('identity').attr('category');
+ var type = $(handleXML).find('identity').attr('type');
+ var named = $(handleXML).find('identity').attr('name');
+
+ if(named)
+ gName = named;
+ else
+ gName = '';
+
+ var one, two, three, four, five;
+
+ // Get the features that this entity supports
+ var findFeature = $(handleXML).find('feature');
+
+ for(i in findFeature) {
+ var current = findFeature.eq(i).attr('var');
+
+ switch(current) {
+ case NS_SEARCH:
+ one = 1;
+ break;
+
+ case NS_MUC:
+ two = 1;
+ break;
+
+ case NS_REGISTER:
+ three = 1;
+ break;
+
+ case NS_COMMANDS:
+ four = 1;
+ break;
+
+ case NS_DISCO_ITEMS:
+ five = 1;
+ break;
+
+ default:
+ break;
+ }
+ }
+
+ var buttons = Array(one, two, three, four, five);
+
+ // We define the toolbox links depending on the supported features
+ var tools = '';
+ var aTools = Array('search', 'join', 'subscribe', 'command', 'browse');
+ var bTools = Array(_e("Search"), _e("Join"), _e("Subscribe"), _e("Command"), _e("Browse"));
+
+ for(i in buttons) {
+ if(buttons[i])
+ tools += '';
+ }
+
+ // As defined in the ref, we detect the type of each category to put an icon
+ switch(category) {
+ case 'account':
+ case 'auth':
+ case 'automation':
+ case 'client':
+ case 'collaboration':
+ case 'component':
+ case 'conference':
+ case 'directory':
+ case 'gateway':
+ case 'headline':
+ case 'hierarchy':
+ case 'proxy':
+ case 'pubsub':
+ case 'server':
+ case 'store':
+ break;
+
+ default:
+ category = 'others';
+ }
+
+ // We display the item we found
+ $(pathID + ' .disco-' + category + ' .disco-category-title').after(
+ '' +
+ '' +
+ '
'
+ );
+
+ // We display the category
+ $(pathID + ' .disco-' + category).show();
+ }
+
+ else {
+ $(pathID + ' .disco-others .disco-category-title').after(
+ '' + from + '
' +
+ '' + gName + '
' +
+ '' + tools + '
' +
+ '' +
+ '' +
+ '
'
+ );
+
+ // We display the category
+ $(pathID + ' .disco-others').show();
+ }
+
+ // We hide the waiting stuffs if there's no remaining loading items
+ if(!$(pathID + ' .disco-wait .' + target + '-oneresult').size())
+ $(pathID + ' .disco-wait, #' + target + ' .wait').hide();
+}
+
+// Cleans the current data-form popup
+function cleanDataForm(target) {
+ if(target == 'discovery')
+ cleanDiscovery();
+ else
+ $('#' + target + ' div.results').empty();
+}
+
+// Displays the no result indicator
+function noResultDataForm(path) {
+ $(path).prepend('' + from + '
' +
+ '' + _e("Service offline or broken") + '
' +
+ '' + _e("Sorry, but the entity didn't return any result!") + '
'); +} diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/datastore.js b/sources/extend/addon/matrix/jappixmini/jappix/js/datastore.js new file mode 100644 index 00000000..b818b301 --- /dev/null +++ b/sources/extend/addon/matrix/jappixmini/jappix/js/datastore.js @@ -0,0 +1,209 @@ +/* + +Jappix - An open social platform +These are the temporary/persistent data store functions + +------------------------------------------------- + +License: AGPL +Author: Vanaryon +Last revision: 23/06/11 + +*/ + +// Temporary: returns whether it is available or not +function hasDB() { + if(window.sessionStorage) + return true; + + return false; +} + +// Temporary: used to read a database entry +function getDB(type, id) { + try { + return sessionStorage.getItem(type + '_' + id); + } + + catch(e) { + logThis('Error while getting a temporary database entry (' + type + ' -> ' + id + '): ' + e, 1); + + return null; + } +} + +// Temporary: used to update a database entry +function setDB(type, id, value) { + try { + sessionStorage.setItem(type + '_' + id, value); + + return true; + } + + catch(e) { + logThis('Error while writing a temporary database entry (' + type + ' -> ' + id + '): ' + e, 1); + + return false; + } +} + +// Temporary: used to remove a database entry +function removeDB(type, id) { + try { + sessionStorage.removeItem(type + '_' + id); + + return true; + } + + catch(e) { + logThis('Error while removing a temporary database entry (' + type + ' -> ' + id + '): ' + e, 1); + + return false; + } +} + +// Temporary: used to check a database entry exists +function existDB(type, id) { + var read = getDB(type, id); + + if(read != null) + return true; + + return false; +} + +// Temporary: used to clear all the database +function resetDB() { + try { + sessionStorage.clear(); + + logThis('Temporary database cleared.', 3); + + return true; + } + + catch(e) { + logThis('Error while clearing temporary database: ' + e, 1); + + return false; + } +} + +// Persistent: returns whether it is available or not +function hasPersistent() { + if(window.localStorage) + return true; + + return false; +} + +// Persistent: used to read a database entry +function getPersistent(type, id) { + try { + return localStorage.getItem(type + '_' + id); + } + + catch(e) { + logThis('Error while getting a persistent database entry (' + type + ' -> ' + id + '): ' + e, 1); + + return null; + } +} + +// Persistent: used to update a database entry +function setPersistent(type, id, value) { + try { + localStorage.setItem(type + '_' + id, value); + + return true; + } + + // Database might be full + catch(e) { + logThis('Retrying: could not write a persistent database entry (' + type + ' -> ' + id + '): ' + e, 2); + + // Flush it! + flushPersistent(); + + // Set the item again + try { + localStorage.setItem(type + '_' + id, value); + + return true; + } + + // New error! + catch(e) { + logThis('Aborted: error while writing a persistent database entry (' + type + ' -> ' + id + '): ' + e, 1); + + return false; + } + } +} + +// Persistent: used to remove a database entry +function removePersistent(type, id) { + try { + localStorage.removeItem(type + '_' + id); + + return true; + } + + catch(e) { + logThis('Error while removing a persistent database entry (' + type + ' -> ' + id + '): ' + e, 1); + + return false; + } +} + +// Persistent: used to check a database entry exists +function existPersistent(type, id) { + var read = getPersistent(type, id); + + if(read != null) + return true; + + return false; +} + +// Persistent: used to clear all the database +function resetPersistent() { + try { + localStorage.clear(); + + logThis('Persistent database cleared.', 3); + + return true; + } + + catch(e) { + logThis('Error while clearing persistent database: ' + e, 1); + + return false; + } +} + +// Persistent: used to flush the database +function flushPersistent() { + try { + // Get the stored session entry + var session = getPersistent('session', 1); + + // Clear the persistent database + localStorage.clear(); + + // Restaure the stored session entry + if(session) + setPersistent('session', 1, session); + + logThis('Persistent database flushed.', 3); + + return true; + } + + catch(e) { + logThis('Error while flushing persistent database: ' + e, 1); + + return false; + } +} diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/date.js b/sources/extend/addon/matrix/jappixmini/jappix/js/date.js new file mode 100644 index 00000000..adbe01c8 --- /dev/null +++ b/sources/extend/addon/matrix/jappixmini/jappix/js/date.js @@ -0,0 +1,214 @@ +/* + +Jappix - An open social platform +These are the date related JS scripts for Jappix + +------------------------------------------------- + +License: AGPL +Author: Vanaryon +Last revision: 17/08/11 + +*/ + +// Gets a stamp from a date +function extractStamp(date) { + return Math.round(date.getTime() / 1000); +} + +// Gets the time from a date +function extractTime(date) { + return date.toLocaleTimeString(); +} + +// Gets the actual date stamp +function getTimeStamp() { + return extractStamp(new Date()); +} + +// Gets the last user activity in seconds +var LAST_ACTIVITY = 0; + +function getLastActivity() { + // Last activity not yet initialized? + if(LAST_ACTIVITY == 0) + return 0; + + return getTimeStamp() - LAST_ACTIVITY; +} + +// Gets the last user available presence in seconds +var PRESENCE_LAST_ACTIVITY = 0; + +function getPresenceLast() { + // Last presence stamp not yet initialized? + if(PRESENCE_LAST_ACTIVITY == 0) + return 0; + + return getTimeStamp() - PRESENCE_LAST_ACTIVITY; +} + +// Generates the time for XMPP +function getXMPPTime(location) { + /* FROM : http://trac.jwchat.org/jsjac/browser/branches/jsjac_1.0/jsextras.js?rev=221 */ + + // Initialize + var jInit = new Date(); + var year, month, day, hours, minutes, seconds; + + // Gets the UTC date + if(location == 'utc') { + year = jInit.getUTCFullYear(); + month = jInit.getUTCMonth(); + day = jInit.getUTCDate(); + hours = jInit.getUTCHours(); + minutes = jInit.getUTCMinutes(); + seconds = jInit.getUTCSeconds(); + } + + // Gets the local date + else { + year = jInit.getFullYear(); + month = jInit.getMonth(); + day = jInit.getDate(); + hours = jInit.getHours(); + minutes = jInit.getMinutes(); + seconds = jInit.getSeconds(); + } + + // Generates the date string + var jDate = year + '-'; + jDate += padZero(month + 1) + '-'; + jDate += padZero(day) + 'T'; + jDate += padZero(hours) + ':'; + jDate += padZero(minutes) + ':'; + jDate += padZero(seconds) + 'Z'; + + // Returns the date string + return jDate; +} + +// Generates then human time +function getCompleteTime() { + var init = new Date(); + var time = padZero(init.getHours()) + ':'; + time += padZero(init.getMinutes()) + ':'; + time += padZero(init.getSeconds()); + + return time; +} + +// Gets the TZO of a date +function getDateTZO() { + // Get the date + var date = new Date(); + var offset = date.getTimezoneOffset(); + + // Default vars + var sign = ''; + var hours = 0; + var minutes = 0; + + // Process a neutral offset + if(offset < 0) { + offset = offset * -1; + sign = '+'; + } + + // Get the values + var n_date = new Date(offset * 60 * 1000); + hours = n_date.getHours() - 1; + minutes = n_date.getMinutes(); + + // Process the TZO + tzo = sign + padZero(hours) + ':' + padZero(minutes); + + // Return the processed value + return tzo; +} + +// Parses a XMPP date (yyyy-mm-dd, hh-mm-ss) into an human-readable one +function parseDate(to_parse) { + var date = Date.jab2date(to_parse); + var parsed = date.toLocaleDateString() + ' (' + date.toLocaleTimeString() + ')'; + + return parsed; +} + +// Parses a XMPP date (yyyy-mm-dd) into an human-readable one +function parseDay(to_parse) { + var date = Date.jab2date(to_parse); + var parsed = date.toLocaleDateString(); + + return parsed; +} + +// Parses a XMPP date (hh-mm-ss) into an human-readable one +function parseTime(to_parse) { + var date = Date.jab2date(to_parse); + var parsed = date.toLocaleTimeString(); + + return parsed; +} + +// Parses a XMPP date stamp into a relative one +function relativeDate(to_parse) { + // Get the current date + var current_date = Date.jab2date(getXMPPTime('utc')); + var current_day = current_date.getDate(); + var current_stamp = current_date.getTime(); + + // Parse the given date + var old_date = Date.jab2date(to_parse); + var old_day = old_date.getDate(); + var old_stamp = old_date.getTime(); + var old_time = old_date.toLocaleTimeString(); + + // Get the day number between the two dates + var days = Math.round((current_stamp - old_stamp) / 86400000); + + // Invalid date? + if(isNaN(old_stamp) || isNaN(days)) + return getCompleteTime(); + + // Is it today? + if(current_day == old_day) + return old_time; + + // It is yesterday? + if(days <= 1) + return _e("Yesterday") + ' - ' + old_time; + + // Is it less than a week ago? + if(days <= 7) + return printf(_e("%s days ago"), days) + ' - ' + old_time; + + // Another longer period + return old_date.toLocaleDateString() + ' - ' + old_time; +} + +// Reads a message delay +function readMessageDelay(node) { + try { + // Initialize + var delay, d_delay; + + // Read the delay + d_delay = jQuery(node).find('delay[xmlns=' + NS_URN_DELAY + ']:first').attr('stamp'); + + // New delay (valid XEP) + if(d_delay) + delay = d_delay; + + // Old delay (obsolete XEP!) + else { + // Try to read the old-school delay + var x_delay = jQuery(node).find('x[xmlns=' + NS_DELAY + ']:first').attr('stamp'); + + if(x_delay) + delay = x_delay.replace(/^(\w{4})(\w{2})(\w{2})T(\w{2}):(\w{2}):(\w{2})Z?(\S+)?/, '$1-$2-$3T$4:$5:$6Z$7'); + } + + return delay; + } catch(e) {} +} diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/directory.js b/sources/extend/addon/matrix/jappixmini/jappix/js/directory.js new file mode 100644 index 00000000..ebe1a570 --- /dev/null +++ b/sources/extend/addon/matrix/jappixmini/jappix/js/directory.js @@ -0,0 +1,87 @@ +/* + +Jappix - An open social platform +These are the directory JS scripts for Jappix + +------------------------------------------------- + +License: AGPL +Author: Vanaryon +Last revision: 03/03/11 + +*/ + +// Opens the directory popup +function openDirectory() { + // Popup HTML content + var html = + '' + _e("User directory") + '
' +
+
+ '' +
+ '
' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' + _e("Server to query") + '
' +
+
+ '' +
+ '' +
+ '' +
+
+ '' + _e("Close") + '' +
+ '
';
+
+ // Create the popup
+ createPopup('directory', html);
+
+ // Associate the events
+ launchDirectory();
+
+ // Start a search!
+ startDirectory();
+
+ return false;
+}
+
+// Quits the directory popup
+function closeDirectory() {
+ // Destroy the popup
+ destroyPopup('directory');
+
+ return false;
+}
+
+// Launches a directory search
+function startDirectory() {
+ // Get the server to query
+ var server = $('#directory .directory-server-input').val();
+
+ // Launch the search!
+ dataForm($('#directory .directory-server-input').val(), 'search', '', '', 'directory');
+
+ logThis('Directory search launched: ' + server);
+
+ return false;
+}
+
+// Plugin launcher
+function launchDirectory() {
+ // Click event
+ $('#directory .bottom .finish').click(closeDirectory);
+
+ // Keyboard event
+ $('#directory .directory-server-input').keyup(function(e) {
+ if(e.keyCode == 13) {
+ // No value?
+ if(!$(this).val())
+ $(this).val(HOST_VJUD);
+
+ // Start the directory search
+ startDirectory();
+
+ return false;
+ }
+ });
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/discovery.js b/sources/extend/addon/matrix/jappixmini/jappix/js/discovery.js
new file mode 100644
index 00000000..867037b2
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/discovery.js
@@ -0,0 +1,169 @@
+/*
+
+Jappix - An open social platform
+These are the discovery JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 03/03/11
+
+*/
+
+// Opens the discovery popup
+function openDiscovery() {
+ // Popup HTML content
+ var html =
+ '' + _e("Service discovery") + '
' +
+
+ '' +
+ '
' +
+
+ '' +
+ '
' +
+
+ '' + _e("Server to query") + '
' +
+
+ '' +
+ '' +
+ '
' +
+ '' +
+ '
' +
+
+ '' + _e("Accounts") + '
' + + '' +
+ '
' +
+
+ '' + _e("Authentications") + '
' + + '' +
+ '
' +
+
+ '' + _e("Automation") + '
' + + '' +
+ '
' +
+
+ '' + _e("Clients") + '
' + + '' +
+ '
' +
+
+ '' + _e("Collaboration") + '
' + + '' +
+ '
' +
+
+ '' + _e("Components") + '
' + + '' +
+ '
' +
+
+ '' + _e("Rooms") + '
' + + '' +
+ '
' +
+
+ '' + _e("Directories") + '
' + + '' +
+ '
' +
+
+ '' + _e("Gateways") + '
' + + '' +
+ '
' +
+
+ '' + _e("News") + '
' + + '' +
+ '
' +
+
+ '' + _e("Hierarchy") + '
' + + '' +
+ '
' +
+
+ '' + _e("Proxies") + '
' + + '' +
+ '
' +
+
+ '' + _e("Publication/Subscription") + '
' + + '' +
+ '
' +
+
+ '' + _e("Server") + '
' + + '' +
+ '
' +
+
+ '' + _e("Storage") + '
' + + '' +
+ '
' +
+
+ '' + _e("Others") + '
' + + '' +
+ '
' +
+ '' + _e("Loading") + '
' + + '' +
+ '' +
+
+ '' + _e("Close") + '' +
+ '
';
+
+ // Create the popup
+ createPopup('discovery', html);
+
+ // Associate the events
+ launchDiscovery();
+
+ // We request a disco to the default server
+ startDiscovery();
+
+ return false;
+}
+
+// Quits the discovery popup
+function closeDiscovery() {
+ // Destroy the popup
+ destroyPopup('discovery');
+
+ return false;
+}
+
+// Launches a discovery
+function startDiscovery() {
+ /* REF: http://xmpp.org/extensions/xep-0030.html */
+
+ // We get the server to query
+ var discoServer = $('#discovery .disco-server-input').val();
+
+ // We launch the items query
+ dataForm(discoServer, 'browse', '', '', 'discovery');
+
+ logThis('Service discovery launched: ' + discoServer);
+
+ return false;
+}
+
+// Cleans the discovery results
+function cleanDiscovery() {
+ // We remove the results
+ $('#discovery .discovery-oneresult, #discovery .oneinstructions, #discovery .onetitle, #discovery .no-results').remove();
+
+ // We clean the user info
+ $('#discovery .disco-server-info').text('');
+
+ // We hide the wait icon, the no result alert and the results
+ $('#discovery .wait, #discovery .disco-category').hide();
+}
+
+// Plugin launcher
+function launchDiscovery() {
+ // Click event
+ $('#discovery .bottom .finish').click(closeDiscovery);
+
+ // Keyboard event
+ $('#discovery .disco-server-input').keyup(function(e) {
+ if(e.keyCode == 13) {
+ // No value?
+ if(!$(this).val())
+ $(this).val(HOST_MAIN);
+
+ // Start the discovery
+ startDiscovery();
+
+ return false;
+ }
+ });
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/error.js b/sources/extend/addon/matrix/jappixmini/jappix/js/error.js
new file mode 100644
index 00000000..c16ca2a5
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/error.js
@@ -0,0 +1,139 @@
+/*
+
+Jappix - An open social platform
+These are the error functions for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 02/04/11
+
+*/
+
+// Shows the given error output
+function showError(condition, reason, type) {
+ // Enough data to output the error
+ if(condition || reason) {
+ // Initialize the error text
+ var eText = '';
+
+ // Any error condition
+ if(condition)
+ eText += condition;
+
+ // Any error type
+ if(type && eText)
+ eText += ' (' + type + ')';
+
+ // Any error reason
+ if(reason) {
+ if(eText)
+ eText += ' - ';
+
+ eText += reason;
+ }
+
+ // We reveal the error
+ openThisError(1);
+
+ // Create the error text
+ $('#board .one-board.error[data-id=1] span').text(eText);
+ }
+
+ // Not enough data to output the error: output a generic board
+ else
+ openThisError(2);
+}
+
+// Handles the error from a packet and return true if any error
+function handleError(packet) {
+ /* REF: http://xmpp.org/extensions/xep-0086.html */
+
+ // Initialize
+ var type, code, reason, condition;
+ var node = $(packet);
+
+ // First level error (connection error)
+ if(node.is('error')) {
+ // Get the value
+ code = node.attr('code');
+
+ // Specific error reason
+ switch(code) {
+ case '401':
+ reason = _e("Authorization failed");
+ break;
+
+ case '409':
+ reason = _e("Registration failed, please choose a different username");
+ break;
+
+ case '503':
+ reason = _e("Service unavailable");
+ break;
+
+ case '500':
+ reason = _e("Internal server error, try later");
+ break;
+
+ default:
+ reason = node.find('text').text();
+ break;
+ }
+
+ // Remove the general wait item (security)
+ removeGeneralWait();
+
+ // Show reconnect pane
+ if(CURRENT_SESSION && CONNECTED) {
+ // Anonymous?
+ if(isAnonymous())
+ createReconnect('anonymous');
+ else
+ createReconnect('normal');
+ }
+
+ // Show the homepage (security)
+ else if(!CURRENT_SESSION || !CONNECTED) {
+ $('#home').show();
+ pageTitle('home');
+ }
+
+ // Still connected? (security)
+ if(isConnected())
+ con.disconnect();
+
+ logThis('First level error received.', 1);
+ }
+
+ // Second level error (another error)
+ else if(node.find('error').size()) {
+ type = node.find('error').attr('type');
+ reason = node.find('error text').text();
+ condition = packet.getElementsByTagName('error').item(0).childNodes.item(0).nodeName.replace(/-/g, ' ');
+
+ logThis('Second level error received.', 1);
+ }
+
+ // No error
+ else
+ return false;
+
+ // Show the error board
+ showError(condition, reason, type);
+
+ // Return there's an error
+ return true;
+}
+
+// Handles the error reply of a packet
+function handleErrorReply(packet) {
+ return handleError(packet.getNode());
+}
+
+// Handles the error reply for a message
+function handleMessageError(packet) {
+ if(!handleErrorReply(packet))
+ handleMessage(packet);
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/favorites.js b/sources/extend/addon/matrix/jappixmini/jappix/js/favorites.js
new file mode 100644
index 00000000..69a042e8
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/favorites.js
@@ -0,0 +1,537 @@
+/*
+
+Jappix - An open social platform
+These are the favorites JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 23/06/11
+
+*/
+
+// Opens the favorites popup
+function openFavorites() {
+ // Popup HTML content
+ var html =
+ '' + _e("Manage favorite rooms") + '
' +
+
+ '' +
+ '
' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ _e("Change favorites") +
+ '
' +
+
+ '' +
+ '' +
+
+ _e("Search a room") +
+ '
' +
+ '' +
+ '
' +
+ '' +
+ '
' +
+
+ '' +
+ '
' +
+
+ '' + _e("Select a favorite") + '
' +
+
+ '' +
+ '' +
+ '
' +
+ '' +
+ '' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ '' +
+ '
' +
+
+ '' +
+ '' +
+ '
' +
+ '' +
+ '
' +
+
+ '' + _e("Search a room on") + '
' +
+
+ '' +
+ '' +
+ '
' +
+ '' + _e("No room found on this server.") + '
' + + '' +
+ '' +
+
+ '' + _e("Close") + '' +
+ '
';
+
+ // Create the popup
+ createPopup('favorites', html);
+
+ // Load the favorites
+ loadFavorites();
+
+ // Associate the events
+ launchFavorites();
+}
+
+// Resets the favorites elements
+function resetFavorites() {
+ var path = '#favorites ';
+
+ $(path + '.wait, ' + path + '.fedit-terminate').hide();
+ $(path + '.fedit-add').show();
+ $(path + '.fsearch-oneresult').remove();
+ $(path + 'input').val('');
+ $(path + '.please-complete').removeClass('please-complete');
+ $(path + '.fedit-nick').val(getNick());
+ $(path + '.fsearch-head-server, ' + path + '.fedit-server').val(HOST_MUC);
+ $(path + '.fedit-autojoin').attr('checked', false);
+}
+
+// Quits the favorites popup
+function quitFavorites() {
+ // Destroy the popup
+ destroyPopup('favorites');
+
+ return false;
+}
+
+// Adds a room to the favorites
+function addThisFavorite(roomXID, roomName) {
+ // Button path
+ var button = '#favorites .fsearch-results div[data-xid=' + escape(roomXID) + '] a.one-button';
+
+ // Add a remove button instead of the add one
+ $(button + '.add').replaceWith('' + _e("Remove") + '');
+
+ // Click event
+ $(button + '.remove').click(function() {
+ return removeThisFavorite(roomXID, roomName);
+ });
+
+ // Hide the add button in the (opened?) groupchat
+ $('#' + hex_md5(roomXID) + ' .tools-add').hide();
+
+ // Add the database entry
+ displayFavorites(roomXID, explodeThis(' (', roomName, 0), getNick(), '0', '');
+
+ // Publish the favorites
+ favoritePublish();
+
+ return false;
+}
+
+// Removes a room from the favorites
+function removeThisFavorite(roomXID, roomName) {
+ // Button path
+ var button = '#favorites .fsearch-results div[data-xid=' + escape(roomXID) + '] a.one-button';
+
+ // Add a remove button instead of the add one
+ $(button + '.remove').replaceWith('' + _e("Add") + '');
+
+ // Click event
+ $(button + '.add').click(function() {
+ return addThisFavorite(roomXID, roomName);
+ });
+
+ // Show the add button in the (opened?) groupchat
+ $('#' + hex_md5(roomXID) + ' .tools-add').show();
+
+ // Remove the favorite
+ removeFavorite(roomXID, true);
+
+ // Publish the favorites
+ favoritePublish();
+
+ return false;
+}
+
+// Edits a favorite
+function editFavorite() {
+ // Path to favorites
+ var favorites = '#favorites .';
+
+ // Reset the favorites
+ resetFavorites();
+
+ // Show the edit/remove button, hide the others
+ $(favorites + 'fedit-terminate').hide();
+ $(favorites + 'fedit-edit').show();
+ $(favorites + 'fedit-remove').show();
+
+ // We retrieve the values
+ var xid = $(favorites + 'fedit-head-select').val();
+ var data = XMLFromString(getDB('favorites', xid));
+
+ // If this is not the default room
+ if(xid != 'none') {
+ // We apply the values
+ $(favorites + 'fedit-title').val($(data).find('name').text());
+ $(favorites + 'fedit-nick').val($(data).find('nick').text());
+ $(favorites + 'fedit-chan').val(getXIDNick(xid));
+ $(favorites + 'fedit-server').val(getXIDHost(xid));
+ $(favorites + 'fedit-password').val($(data).find('password').text());
+
+ if($(data).find('autojoin').text() == '1')
+ $(favorites + 'fedit-autojoin').attr('checked', true);
+ }
+
+ else
+ resetFavorites();
+}
+
+// Adds a favorite
+function addFavorite() {
+ // Path to favorites
+ var favorites = '#favorites .';
+
+ // We reset the inputs
+ $(favorites + 'fedit-title, ' + favorites + 'fedit-nick, ' + favorites + 'fedit-chan, ' + favorites + 'fedit-server, ' + favorites + 'fedit-password').val('');
+
+ // Show the add button, hide the others
+ $(favorites + 'fedit-terminate').hide();
+ $(favorites + 'fedit-add').show();
+}
+
+// Terminate a favorite editing
+function terminateThisFavorite(type) {
+ // Path to favorites
+ var favorites = '#favorites ';
+
+ // We get the values of the current edited groupchat
+ var old_xid = $(favorites + '.fedit-head-select').val();
+
+ var title = $(favorites + '.fedit-title').val();
+ var nick = $(favorites + '.fedit-nick').val();
+ var room = $(favorites + '.fedit-chan').val();
+ var server = $(favorites + '.fedit-server').val();
+ var xid = room + '@' + server;
+ var password = $(favorites + '.fedit-password').val();
+ var autojoin = '0';
+
+ if($(favorites + '.fedit-autojoin').filter(':checked').size())
+ autojoin = '1';
+
+ // We check the missing values and send this if okay
+ if((type == 'add') || (type == 'edit')) {
+ if(title && nick && room && server) {
+ // Remove the edited room
+ if(type == 'edit')
+ removeFavorite(old_xid, true);
+
+ // Display the favorites
+ displayFavorites(xid, title, nick, autojoin, password);
+
+ // Reset the inputs
+ resetFavorites();
+ }
+
+ else {
+ $(favorites + 'input[required]').each(function() {
+ var select = $(this);
+
+ if(!select.val())
+ $(document).oneTime(10, function() {
+ select.addClass('please-complete').focus();
+ });
+ else
+ select.removeClass('please-complete');
+ });
+ }
+ }
+
+ // Must remove a favorite?
+ else if(type == 'remove') {
+ removeFavorite(old_xid, true);
+
+ // Reset the inputs
+ resetFavorites();
+ }
+
+ // Publish the new favorites
+ favoritePublish();
+
+ logThis('Action on this bookmark: ' + room + '@' + server + ' / ' + type, 3);
+
+ return false;
+}
+
+// Removes a favorite
+function removeFavorite(xid, database) {
+ // We remove the target favorite everywhere needed
+ $('.buddy-conf-groupchat-select option[value=' + xid + ']').remove();
+ $('.fedit-head-select option[value=' + xid + ']').remove();
+
+ // Must remove it from database?
+ if(database)
+ removeDB('favorites', xid);
+}
+
+// Sends a favorite to the XMPP server
+function favoritePublish() {
+ var iq = new JSJaCIQ();
+ iq.setType('set');
+
+ var query = iq.setQuery(NS_PRIVATE);
+ var storage = query.appendChild(iq.buildNode('storage', {'xmlns': NS_BOOKMARKS}));
+
+ // We generate the XML
+ for(var i = 0; i < sessionStorage.length; i++) {
+ // Get the pointer values
+ var current = sessionStorage.key(i);
+
+ // If the pointer is on a stored favorite
+ if(explodeThis('_', current, 0) == 'favorites') {
+ var data = XMLFromString(sessionStorage.getItem(current));
+ var xid = $(data).find('xid').text();
+ var rName = $(data).find('name').text();
+ var nick = $(data).find('nick').text();
+ var password = $(data).find('password').text();
+ var autojoin = $(data).find('autojoin').text();
+
+ // We create the node for this groupchat
+ var item = storage.appendChild(iq.buildNode('conference', {'name': rName, 'jid': xid, 'autojoin': autojoin, xmlns: NS_BOOKMARKS}));
+ item.appendChild(iq.buildNode('nick', {xmlns: NS_BOOKMARKS}, nick));
+
+ if(password)
+ item.appendChild(iq.buildNode('password', {xmlns: NS_BOOKMARKS}, password));
+
+ logThis('Bookmark sent: ' + xid, 3);
+ }
+ }
+
+ con.send(iq);
+}
+
+// Gets a list of the MUC items on a given server
+function getGCList() {
+ var path = '#favorites .';
+ var gcServer = $('.fsearch-head-server').val();
+
+ // We reset some things
+ $(path + 'fsearch-oneresult').remove();
+ $(path + 'fsearch-noresults').hide();
+ $(path + 'wait').show();
+
+ var iq = new JSJaCIQ();
+ iq.setType('get');
+ iq.setTo(gcServer);
+
+ iq.setQuery(NS_DISCO_ITEMS);
+
+ con.send(iq, handleGCList);
+}
+
+// Handles the MUC items list
+function handleGCList(iq) {
+ var path = '#favorites .';
+ var from = fullXID(getStanzaFrom(iq));
+
+ if (!iq || (iq.getType() != 'result')) {
+ openThisError(3);
+
+ $(path + 'wait').hide();
+
+ logThis('Error while retrieving the rooms: ' + from, 1);
+ }
+
+ else {
+ var handleXML = iq.getQuery();
+
+ if($(handleXML).find('item').size()) {
+ // Initialize the HTML code
+ var html = '';
+
+ $(handleXML).find('item').each(function() {
+ var roomXID = $(this).attr('jid');
+ var roomName = $(this).attr('name');
+
+ if(roomXID && roomName) {
+ // Escaped values
+ var escaped_xid = encodeOnclick(roomXID);
+ var escaped_name = encodeOnclick(roomName);
+
+ // Initialize the room HTML
+ html += '' +
+ '
';
+ }
+ });
+
+ // Append this code to the popup
+ $(path + 'fsearch-results').append(html);
+ }
+
+ else
+ $(path + 'fsearch-noresults').show();
+
+ logThis('Rooms retrieved: ' + from, 3);
+ }
+
+ $(path + 'wait').hide();
+}
+
+// Joins a groupchat from favorites
+function joinFavorite(room) {
+ quitFavorites();
+ checkChatCreate(room, 'groupchat', '', '', getXIDNick(room));
+
+ return false;
+}
+
+// Displays a given favorite
+function displayFavorites(xid, name, nick, autojoin, password) {
+ // Generate the HTML code
+ var html = '';
+
+ // Remove the existing favorite
+ removeFavorite(xid, false);
+
+ // We complete the select forms
+ $('#buddy-list .gc-join-first-option, #favorites .fedit-head-select-first-option').after(html);
+
+ // We store the informations
+ var value = '' + roomName.htmlEnc() + '
' +
+ '' + _e("Join") + '';
+
+ // This room is yet a favorite
+ if(existDB('favorites', roomXID))
+ html += '' + _e("Remove") + '';
+ else
+ html += '' + _e("Add") + '';
+
+ // Close the room HTML
+ html += '
' + after;
+}
+
+// Filters a given message
+function filterThisMessage(neutralMessage, nick, html_encode) {
+ var filteredMessage = neutralMessage;
+
+ // We encode the HTML special chars
+ if(html_encode)
+ filteredMessage = filteredMessage.htmlEnc();
+
+ // /me command
+ filteredMessage = filteredMessage.replace(/((^)|((.+)(>)))(\/me )([^<]+)/, nick + ' $7')
+
+ // We replace the smilies text into images
+ .replace(/(:-?@)($|\s|<)/gi, emoteImage('angry', '$1', '$2'))
+ .replace(/(:-?\[)($|\s|<)/gi, emoteImage('bat', '$1', '$2'))
+ .replace(/(\(B\))($|\s|<)/g, emoteImage('beer', '$1', '$2'))
+ .replace(/((:-?D)|(XD))($|\s|<)/gi, emoteImage('biggrin', '$1', '$4'))
+ .replace(/(:-?\$)($|\s|<)/gi, emoteImage('blush', '$1', '$2'))
+ .replace(/(\(Z\))($|\s|<)/g, emoteImage('boy', '$1', '$2'))
+ .replace(/(\(W\))($|\s|<)/g, emoteImage('brflower', '$1', '$2'))
+ .replace(/((<\/3)|(\(U\)))($|\s|<)/g, emoteImage('brheart', '$1', '$4'))
+ .replace(/(\(C\))($|\s|<)/g, emoteImage('coffee', '$1', '$2'))
+ .replace(/((8-\))|(\(H\)))($|\s|<)/g, emoteImage('coolglasses', '$1', '$4'))
+ .replace(/(:'-?\()($|\s|<)/gi, emoteImage('cry', '$1', '$2'))
+ .replace(/(\(%\))($|\s|<)/g, emoteImage('cuffs', '$1', '$2'))
+ .replace(/(\]:-?>)($|\s|<)/gi, emoteImage('devil', '$1', '$2'))
+ .replace(/(\(D\))($|\s|<)/g, emoteImage('drink', '$1', '$2'))
+ .replace(/(@}->--)($|\s|<)/gi, emoteImage('flower', '$1', '$2'))
+ .replace(/((:-?\/)|(:-?S))($|\s|<)/gi, emoteImage('frowning', '$1', '$4'))
+ .replace(/(\(X\))($|\s|<)/g, emoteImage('girl', '$1', '$2'))
+ .replace(/((<3)|(\(L\)))($|\s|<)/g, emoteImage('heart', '$1', '$4'))
+ .replace(/(\(}\))($|\s|<)/g, emoteImage('hugleft', '$1', '$2'))
+ .replace(/(\({\))($|\s|<)/g, emoteImage('hugright', '$1', '$2'))
+ .replace(/(:-?{})($|\s|<)/gi, emoteImage('kiss', '$1', '$2'))
+ .replace(/(\(I\))($|\s|<)/g, emoteImage('lamp', '$1', '$2'))
+ .replace(/(:-?3)($|\s|<)/gi, emoteImage('lion', '$1', '$2'))
+ .replace(/(\(E\))($|\s|<)/g, emoteImage('mail', '$1', '$2'))
+ .replace(/(\(S\))($|\s|<)/g, emoteImage('moon', '$1', '$2'))
+ .replace(/(\(8\))($|\s|<)/g, emoteImage('music', '$1', '$2'))
+ .replace(/((=-?O)|(:-?O))($|\s|<)/gi, emoteImage('oh', '$1', '$4'))
+ .replace(/(\(T\))($|\s|<)/g, emoteImage('phone', '$1', '$2'))
+ .replace(/(\(P\))($|\s|<)/g, emoteImage('photo', '$1', '$2'))
+ .replace(/(:-?!)($|\s|<)/gi, emoteImage('puke', '$1', '$2'))
+ .replace(/(\(@\))($|\s|<)/g, emoteImage('pussy', '$1', '$2'))
+ .replace(/(\(R\))($|\s|<)/g, emoteImage('rainbow', '$1', '$2'))
+ .replace(/(:-?\))($|\s|<)/gi, emoteImage('smile', '$1', '$2'))
+ .replace(/(\(\*\))($|\s|<)/g, emoteImage('star', '$1', '$2'))
+ .replace(/(:-?\|)($|\s|<)/gi, emoteImage('stare', '$1', '$2'))
+ .replace(/(\(N\))($|\s|<)/g, emoteImage('thumbdown', '$1', '$2'))
+ .replace(/(\(Y\))($|\s|<)/g, emoteImage('thumbup', '$1', '$2'))
+ .replace(/(:-?P)($|\s|<)/gi, emoteImage('tongue', '$1', '$2'))
+ .replace(/(:-?\()($|\s|<)/gi, emoteImage('unhappy', '$1', '$2'))
+ .replace(/(;-?\))($|\s|<)/gi, emoteImage('wink', '$1', '$2'))
+
+ // Text in bold
+ .replace(/(^|\s|>)((\*)([^<>'"]+)(\*))($|\s|<)/gi, '$1$2$6')
+
+ // Italic text
+ .replace(/(^|\s|>)((\/)([^<>'"]+)(\/))($|\s|<)/gi, '$1$2$6')
+
+ // Underlined text
+ .replace(/(^|\s|>)((_)([^<>'"]+)(_))($|\s|<)/gi, '$1$2$6');
+
+ // Add the links
+ if(html_encode)
+ filteredMessage = applyLinks(filteredMessage, 'desktop');
+
+ // Filter integratebox links
+ filteredMessage = filterIntegrateBox(filteredMessage);
+
+ return filteredMessage;
+}
+
+// Filters a xHTML message to be displayed in Jappix
+function filterThisXHTML(code) {
+ // Allowed elements array
+ var elements = new Array(
+ 'a',
+ 'abbr',
+ 'acronym',
+ 'address',
+ 'blockquote',
+ 'body',
+ 'br',
+ 'cite',
+ 'code',
+ 'dd',
+ 'dfn',
+ 'div',
+ 'dt',
+ 'em',
+ 'h1',
+ 'h2',
+ 'h3',
+ 'h4',
+ 'h5',
+ 'h6',
+ 'head',
+ 'html',
+ 'img',
+ 'kbd',
+ 'li',
+ 'ol',
+ 'p',
+ 'pre',
+ 'q',
+ 'samp',
+ 'span',
+ 'strong',
+ 'title',
+ 'ul',
+ 'var'
+ );
+
+ // Allowed attributes array
+ var attributes = new Array(
+ 'accesskey',
+ 'alt',
+ 'charset',
+ 'cite',
+ 'class',
+ 'height',
+ 'href',
+ 'hreflang',
+ 'id',
+ 'longdesc',
+ 'profile',
+ 'rel',
+ 'rev',
+ 'src',
+ 'style',
+ 'tabindex',
+ 'title',
+ 'type',
+ 'uri',
+ 'version',
+ 'width',
+ 'xml:lang',
+ 'xmlns'
+ );
+
+ // Remove forbidden elements
+ $(code).find('html body *').each(function() {
+ // This element is not authorized
+ if(!existArrayValue(elements, (this).nodeName.toLowerCase()))
+ $(this).remove();
+ });
+
+ // Remove forbidden attributes
+ $(code).find('html body *').each(function() {
+ // Put a pointer on this element (jQuery way & normal way)
+ var cSelector = $(this);
+ var cElement = (this);
+
+ // Loop the attributes of the current element
+ $(cElement.attributes).each(function(index) {
+ // Read the current attribute
+ var cAttr = cElement.attributes[index];
+ var cName = cAttr.name;
+ var cVal = cAttr.value;
+
+ // This attribute is not authorized, or contains JS code
+ if(!existArrayValue(attributes, cName.toLowerCase()) || ((cVal.toLowerCase()).match(/(^|"|')javascript:/)))
+ cSelector.removeAttr(cName);
+ });
+ });
+
+ // Filter some other elements
+ $(code).find('a').attr('target', '_blank');
+
+ return $(code).find('html body').html();
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/groupchat.js b/sources/extend/addon/matrix/jappixmini/jappix/js/groupchat.js
new file mode 100644
index 00000000..c8dd13b1
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/groupchat.js
@@ -0,0 +1,283 @@
+/*
+
+Jappix - An open social platform
+These are the groupchat JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Authors: Vanaryon, Maranda, Eric
+Last revision: 28/08/11
+
+*/
+
+// Displays the MUC admin elements
+function displayMucAdmin(affiliation, id, xid, statuscode) {
+ // We must be in the "login" mode
+ if(isAnonymous())
+ return;
+
+ // We check if the user is a room owner or administrator to give him privileges
+ if(affiliation == 'owner' || affiliation == 'admin')
+ $('#' + id + ' .tools-mucadmin').show();
+
+ // We check if the room hasn't been yet created
+ if(statuscode == 201)
+ openThisInfo(4);
+
+ // We add the click event
+ $('#' + id + ' .tools-mucadmin').click(function() {
+ openMucAdmin(xid, affiliation);
+ });
+}
+
+// Initializes a connection with a MUC groupchat
+function getMUC(room, nickname, password) {
+ // Room hash
+ var hash = hex_md5(room);
+
+ // Reset the elements
+ $('#' + hash + ' .muc-ask').remove();
+ $('#' + hash + ' .compose').show();
+
+ // No nickname?
+ if(!nickname) {
+ // Get some values
+ if(!isAnonymous())
+ nickname = getNick();
+ else
+ nickname = ANONYMOUS_NICK;
+
+ // If the nickname could not be retrieved, ask it
+ if(!nickname)
+ generateMUCAsk('nickname', room, hash, nickname, password);
+ }
+
+ // Got our nickname?
+ if(nickname) {
+ // Get our general presence
+ var show = getDB('presence-show', 1);
+ var status = getDB('options', 'presence-status');
+
+ // Set my nick
+ $('#' + hash).attr('data-nick', escape(nickname));
+
+ // Send the appropriate presence
+ sendPresence(room + '/' + nickname, '', show, status, '', true, password, handleMUC);
+ }
+
+ return false;
+}
+
+// Handles the MUC main elements
+function handleMUC(presence) {
+ // We get the xml content
+ var xml = presence.getNode();
+ var from = fullXID(getStanzaFrom(presence));
+ var room = bareXID(from);
+ var nickname = thisResource(from);
+ var hash = hex_md5(room);
+
+ // No ID: must fix M-Link bug
+ if(presence.getID() == null)
+ presence.setID(1);
+
+ logThis('First MUC presence: ' + from, 3);
+
+ // Catch the errors
+ if(!handleError(xml)) {
+ // Define some stuffs
+ var muc_user = $(xml).find('x[xmlns=' + NS_MUC_USER + ']');
+ var affiliation = muc_user.find('item').attr('affiliation');
+ var statuscode = parseInt(muc_user.find('status').attr('code'));
+
+ // Handle my presence
+ handlePresence(presence);
+
+ // Check if I am a room owner
+ displayMucAdmin(affiliation, hash, room, statuscode);
+
+ // Tell the MUC we can notify the incoming presences
+ $(document).oneTime('15s', function() {
+ $('#' + hash).attr('data-initial', 'true');
+ });
+
+ // Enable the chatting input
+ $(document).oneTime(10, function() {
+ $('#' + hash + ' .message-area').removeAttr('disabled').focus();
+ });
+ }
+
+ // A password is required
+ else if($(xml).find('error[type=auth] not-authorized').size())
+ generateMUCAsk('password', room, hash, nickname);
+
+ // There's a nickname conflict
+ else if($(xml).find('error[type=cancel] conflict').size())
+ generateMUCAsk('nickname', room, hash);
+}
+
+// Generates a correct MUC asker
+function generateMUCAsk(type, room, hash, nickname, password) {
+ // Generate the path to the elements
+ var path_to = '#' + hash + ' .muc-ask';
+
+ // Define the label text
+ var label_text;
+
+ switch(type) {
+ case 'nickname':
+ label_text = _e("Nickname");
+ break;
+
+ case 'password':
+ label_text = _e("Password");
+ break;
+ }
+
+ // Create the HTML markup
+ $('#' + hash + ' .compose').hide();
+
+ $('#' + hash).append(
+ '' +
+ '' +
+ '' +
+ '
'
+ );
+
+ // When a key is pressed in the input
+ $(path_to + ' input').keyup(function(e) {
+ var value_input = $(this).val();
+
+ // Enter key pressed
+ if((e.keyCode == 13) && value_input) {
+ if(type == 'nickname')
+ nickname = value_input;
+ else if(type == 'password')
+ password = value_input;
+
+ return getMUC(room, nickname, password);
+ }
+ });
+
+ // Focus on the input
+ $(document).oneTime(10, function() {
+ $(path_to + ' input').focus();
+ });
+}
+
+// Creates a new groupchat
+function groupchatCreate(hash, room, chan, nickname, password) {
+ /* REF: http://xmpp.org/extensions/xep-0045.html */
+
+ logThis('New groupchat: ' + room, 3);
+
+ // Create the chat content
+ generateChat('groupchat', hash, room, chan);
+
+ // Create the chat switcher
+ generateSwitch('groupchat', hash, room, chan);
+
+ // The icons-hover functions
+ tooltipIcons(room, hash);
+
+ // Click event on the add tool
+ $('#' + hash + ' .tools-add').click(function() {
+ // Hide the icon (to tell the user all is okay)
+ $(this).hide();
+
+ // Add the groupchat to the user favorites
+ addThisFavorite(room, chan);
+ });
+
+ // Must show the add button?
+ if(!existDB('favorites', room))
+ $('#' + hash + ' .tools-add').show();
+
+ // The event handlers
+ var inputDetect = $('#' + hash + ' .message-area');
+
+ // Focus event
+ inputDetect.focus(function() {
+ chanCleanNotify(hash);
+ })
+
+ // Blur event
+ inputDetect.blur(function() {
+ resetAutocompletion(hash);
+ })
+
+ // Lock to the input
+ inputDetect.keypress(function(e) {
+ // Enter key
+ if(e.keyCode == 13) {
+ // Add a new line
+ if(e.shiftKey)
+ inputDetect.val(inputDetect.val() + '\n');
+
+ // Send the message
+ else {
+ sendMessage(hash, 'groupchat');
+
+ // Reset the composing database entry
+ setDB('chatstate', room, 'off');
+ }
+
+ return false;
+ }
+
+ // Tabulation key
+ else if(e.keyCode == 9) {
+ createAutocompletion(hash);
+
+ return false;
+ }
+
+ // Reset the autocompleter
+ else
+ resetAutocompletion(hash);
+ });
+
+ // Chatstate events
+ eventsChatState(inputDetect, room, hash);
+
+ // Get the current muc informations and content
+ getMUC(room, nickname, password);
+}
+
+// Joins the defined groupchats
+function joinConfGroupchats() {
+ // Nothing to join?
+ if(!GROUPCHATS_JOIN)
+ return;
+
+ // Values array
+ var muc_arr = [GROUPCHATS_JOIN];
+ var new_arr = [];
+
+ // Try to split it
+ if(GROUPCHATS_JOIN.indexOf(',') != -1)
+ muc_arr = GROUPCHATS_JOIN.split(',');
+
+ for(i in muc_arr) {
+ // Get the current value
+ var muc_current = trim(muc_arr[i]);
+
+ // No current value?
+ if(!muc_current)
+ continue;
+
+ // Filter the current value
+ muc_current = generateXID(muc_current, 'groupchat');
+
+ // Add the current value
+ if(!existArrayValue(new_arr, muc_current))
+ new_arr.push(muc_current);
+ }
+
+ // Join the chats
+ if(new_arr.length) {
+ for(g in new_arr)
+ checkChatCreate(new_arr[g], 'groupchat');
+ }
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/home.js b/sources/extend/addon/matrix/jappixmini/jappix/js/home.js
new file mode 100644
index 00000000..5322501d
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/home.js
@@ -0,0 +1,371 @@
+/*
+
+Jappix - An open social platform
+These are the homepage JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Authors: Vanaryon, LinkMauve
+Last revision: 15/01/12
+
+*/
+
+// Allows the user to switch the difference home page elements
+function switchHome(div) {
+ // Path to
+ var home = '#home .';
+ var right = home + 'right ';
+ var current = right + '.homediv.' + div;
+
+ // We switch the div
+ $(right + '.homediv, ' + right + '.top').hide();
+ $(right + '.' + div).show();
+
+ // We reset the homedivs
+ $(home + 'homediv:not(.default), ' + home + 'top:not(.default)').remove();
+
+ // Get the HTML code to display
+ var disable_form = '';
+ var lock_host = '';
+ var code = '';
+
+ // Apply the previous link
+ switch(div) {
+ case 'loginer':
+ case 'anonymouser':
+ case 'registerer':
+ if(!exists(right + '.top.sub')) {
+ // Append the HTML code for previous link
+ $(right + '.top.default').after('« ' + _e("Previous") + '
'); + + // Click event on previous link + $(home + 'top.sub a.previous').click(function() { + return switchHome('default'); + }); + } + + break; + } + + // Apply the form + switch(div) { + // Login tool + case 'loginer': + lock_host = disableInput(LOCK_HOST, 'on'); + code = '' + printf(_e("Login to your existing XMPP account. You can also use the %s to join a groupchat."), '' + _e("anonymous mode") + '') + '
' + + + ''; + + break; + + // Anonymous login tool + case 'anonymouser': + disable_form = disableInput(ANONYMOUS, 'off'); + code = '' + printf(_e("Enter the groupchat you want to join and the nick you want to have. You can also go back to the %s."), '' + _e("login page") + '') + '
' + + + '' + + + '' +
+ _e("Share this link with your friends:") + ' ' +
+ '
';
+
+ break;
+
+ // Register tool
+ case 'registerer':
+ disable_form = disableInput(REGISTRATION, 'off');
+
+ if(!disable_form)
+ lock_host = disableInput(LOCK_HOST, 'on');
+
+ code = '' + _e("Register a new XMPP account to join your friends on your own social cloud. That's simple!") + '
' + + + ''; + + break; + } + + // Form disabled? + if(disable_form) + code += '' +
+ _e("This tool has been disabled, you cannot use it!") +
+ '
';
+
+ // Create this HTML code
+ if(code && !exists(current)) {
+ // Append it!
+ $(right + '.homediv.default').after('' + code + '
');
+
+ // Create the attached events
+ switch(div) {
+ // Login tool
+ case 'loginer':
+ $(current + ' a.to-anonymous').click(function() {
+ return switchHome('anonymouser');
+ });
+
+ $(current + ' a.advanced').click(showAdvanced);
+
+ $(current + ' form').submit(loginForm);
+
+ break;
+
+ // Anonymous login tool
+ case 'anonymouser':
+ $(current + ' a.to-home').click(function() {
+ return switchHome('loginer');
+ });
+
+ $(current + ' form').submit(doAnonymous);
+
+ // Keyup event on anonymous join's room input
+ $(current + ' input.room').keyup(function() {
+ var value = $(this).val();
+ var report = current + ' .report';
+ var span = report + ' span';
+
+ if(!value) {
+ $(report).hide();
+ $(span).text('');
+ }
+
+ else {
+ $(report).show();
+ $(span).text(JAPPIX_LOCATION + '?r=' + value);
+ }
+ });
+
+ break;
+
+ // Register tool
+ case 'registerer':
+ $(current + ' form').submit(registerForm);
+
+ break;
+ }
+ }
+
+ // We focus on the first input
+ $(document).oneTime(10, function() {
+ $(right + 'input:visible:first').focus();
+ });
+
+ return false;
+}
+
+// Allows the user to display the advanced login options
+function showAdvanced() {
+ // Hide the link
+ $('#home a.advanced').hide();
+
+ // Show the fieldset
+ $('#home fieldset.advanced').show();
+
+ return false;
+}
+
+// Reads the login form values
+function loginForm() {
+ // We get the values
+ var lPath = '#home .loginer ';
+ var lServer = $(lPath + '.server').val();
+ var lNick = $(lPath + '.nick').val();
+ var lPass = $(lPath + '.password').val();
+ var lResource = $(lPath + '.resource').val();
+ var lPriority = $(lPath + '.priority').val();
+ var lRemember = $(lPath + '.remember').filter(':checked').size();
+
+ // Enough values?
+ if(lServer && lNick && lPass && lResource && lPriority)
+ doLogin(lNick, lServer, lPass, lResource, lPriority, lRemember);
+
+ // Something is missing?
+ else {
+ $(lPath + 'input[type=text], ' + lPath + 'input[type=password]').each(function() {
+ var select = $(this);
+
+ if(!select.val())
+ $(document).oneTime(10, function() {
+ select.addClass('please-complete').focus();
+ });
+ else
+ select.removeClass('please-complete');
+ });
+ }
+
+ return false;
+}
+
+// Reads the register form values
+function registerForm() {
+ var rPath = '#home .registerer ';
+
+ // Remove the success info
+ $(rPath + '.success').remove();
+
+ // Get the values
+ var username = $(rPath + '.nick').val();
+ var domain = $(rPath + '.server').val();
+ var pass = $(rPath + '.password').val();
+ var spass = $(rPath + '.spassword').val();
+
+ // Enough values?
+ if(domain && username && pass && spass && (pass == spass)) {
+ // We remove the not completed class to avoid problems
+ $('#home .registerer input').removeClass('please-complete');
+
+ // Fire the register event!
+ doRegister(username, domain, pass);
+ }
+
+ // Something is missing?
+ else {
+ $(rPath + 'input[type=text], ' + rPath + 'input[type=password]').each(function() {
+ var select = $(this);
+
+ if(!select.val() || (select.is('#spassword') && pass && (pass != spass)))
+ $(document).oneTime(10, function() {
+ select.addClass('please-complete').focus();
+ });
+ else
+ select.removeClass('please-complete');
+ });
+ }
+
+ return false;
+}
+
+// Plugin launcher
+function launchHome() {
+ // Define the vars
+ var home = '#home ';
+ var button = home + 'button';
+ var corp = home + '.corporation';
+ var locale = home + '.locale';
+
+ // Removes the elements to lighten the DOM
+ $('noscript').remove();
+
+ // Allows the user to switch the home page
+ $(button).click(function() {
+ // Login button
+ if($(this).is('.login'))
+ return switchHome('loginer');
+
+ // Register button
+ else
+ return switchHome('registerer');
+ });
+
+ // Allows the user to view the corporation infobox
+ $(corp).hover(function() {
+ $(corp).addClass('hovered');
+ }, function() {
+ $(corp).removeClass('hovered');
+ });
+
+ // Allows the user to switch the language
+ $(locale).hover(function() {
+ // Initialize the HTML code
+ var keepget = $(locale).attr('data-keepget');
+ var html = '';
+
+ // Generate each locale HTML code
+ for(i in LOCALES_AVAILABLE_ID)
+ html += '' + LOCALES_AVAILABLE_NAMES[i].htmlEnc() + '';
+
+ html += '
';
+
+ // Append the HTML code
+ $(locale).append(html);
+ }, function() {
+ $(locale + ' .list').remove();
+ });
+
+ // Disables the browser HTTP-requests stopper
+ $(document).keydown(function(e) {
+ if((e.keyCode == 27) && !isDeveloper())
+ return false;
+ });
+
+ // Warns for an obsolete browser
+ if(isObsolete()) {
+ // Add the code
+ $(locale).after(
+ ''
+ );
+
+ // Display it later
+ $(home + '.obsolete').oneTime('1s', function() {
+ $(this).slideDown();
+ });
+
+ logThis('Jappix does not support this browser!', 2);
+ }
+
+ logThis('Welcome to Jappix! Happy coding in developer mode!');
+}
+
+// Launch this plugin!
+$(document).ready(launchHome);
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/httpauth.js b/sources/extend/addon/matrix/jappixmini/jappix/js/httpauth.js
new file mode 100644
index 00000000..857de6d6
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/httpauth.js
@@ -0,0 +1,41 @@
+/*
+
+Jappix - An open social platform
+These are the http-auth JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 16/11/10
+
+*/
+
+// Replies to a HTTP request
+function requestReply(value, xml) {
+ // We parse the xml content
+ var from = fullXID(getStanzaFrom(xml));
+ var confirm = $(xml.getNode()).find('confirm');
+ var xmlns = confirm.attr('xmlns');
+ var id = confirm.attr('id');
+ var method = confirm.attr('method');
+ var url = confirm.attr('url');
+
+ // We generate the reply message
+ var aMsg = new JSJaCMessage();
+ aMsg.setTo(from);
+
+ // If "no"
+ if(value == 'no') {
+ aMsg.setType('error');
+ aMsg.appendNode('error', {'code': '401', 'type': 'auth'});
+ }
+
+ // We set the confirm node
+ aMsg.appendNode('confirm', {'xmlns': xmlns, 'url': url, 'id': id, 'method': method});
+
+ // We send the message
+ con.send(aMsg, handleErrorReply);
+
+ logThis('Replying HTTP auth request: ' + from, 3);
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/inbox.js b/sources/extend/addon/matrix/jappixmini/jappix/js/inbox.js
new file mode 100644
index 00000000..9f54cb93
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/inbox.js
@@ -0,0 +1,694 @@
+/*
+
+Jappix - An open social platform
+These are the inbox JS script for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 08/06/11
+
+*/
+
+// Opens the inbox popup
+function openInbox() {
+ // Popup HTML content
+ var html =
+ '' + _e("Your inbox") + '
' +
+
+ '' +
+ '
' +
+
+ '' +
+ '
' +
+
+ '' + _e("Available actions") + '
' +
+
+ '' +
+ '' +
+ '' +
+ '' +
+ '
' +
+ '' +
+ '
' +
+
+ '' + _e("Your inbox is empty.") + '
' + + + '' + + '' +
+ '
' +
+ '' +
+ '
' +
+
+ '' + _e("To") + '
' + + + '' + + '' +
+ '
' +
+
+ '' + _e("Subject") + '
' + + + '' + + '' +
+ '
' +
+
+ '' +
+
+ '' + _e("Content") + '
' + + + '' + + '' +
+ '' + _e("Send message") + '' +
+ '
' +
+ '' +
+ '' +
+
+ '' + _e("Close") + '' +
+ '
';
+
+ // Create the popup
+ createPopup('inbox', html);
+
+ // Associate the events
+ launchInbox();
+
+ // Load the messages
+ loadInbox();
+
+ return false;
+}
+
+// Closes the inbox popup
+function closeInbox() {
+ // Destroy the popup
+ destroyPopup('inbox');
+
+ return false;
+}
+
+// Opens the message compose tool
+function composeInboxMessage(xid) {
+ // Open things
+ openInbox();
+ newInboxMessage();
+
+ // Apply XID
+ $('#inbox .inbox-new-to-input').val(xid);
+
+ // Focus to the next item
+ $(document).oneTime(10, function() {
+ $('#inbox .inbox-new-subject-input').focus();
+ });
+
+ return false;
+}
+
+// Stores the inbox
+function storeInbox() {
+ var iq = new JSJaCIQ();
+ iq.setType('set');
+ var query = iq.setQuery(NS_PRIVATE);
+ var storage = query.appendChild(iq.buildNode('storage', {'xmlns': NS_INBOX}));
+
+ for(var i = 0; i < sessionStorage.length; i++) {
+ // Get the pointer values
+ var current = sessionStorage.key(i);
+
+ // If the pointer is on a stored message
+ if(explodeThis('_', current, 0) == 'inbox') {
+ // Get the values
+ var value = $(XMLFromString(sessionStorage.getItem(current)));
+
+ // Create the storage node
+ storage.appendChild(iq.buildNode('message', {
+ 'id': value.find('id').text().revertHtmlEnc(),
+ 'from': value.find('from').text().revertHtmlEnc(),
+ 'subject': value.find('subject').text().revertHtmlEnc(),
+ 'status': value.find('status').text().revertHtmlEnc(),
+ 'date': value.find('date').text().revertHtmlEnc(),
+ 'xmlns': NS_INBOX
+ },
+
+ value.find('content').text().revertHtmlEnc()
+ ));
+ }
+ }
+
+ con.send(iq);
+}
+
+// Creates a new normal message
+function newInboxMessage() {
+ // Init
+ var mPath = '#inbox .';
+
+ // Reset the previous buddy search
+ resetBuddySearch('#inbox .inbox-new-to');
+
+ // We switch the divs
+ $(mPath + 'inbox-results, #inbox .a-new-message, #inbox .a-delete-messages').hide();
+ $(mPath + 'inbox-new, #inbox .a-show-messages').show();
+
+ // We focus on the first input
+ $(document).oneTime(10, function() {
+ $(mPath + 'inbox-new-to-input').focus();
+ });
+
+ // We reset some stuffs
+ cleanNewInboxMessage();
+
+ return false;
+}
+
+// Cleans the inbox
+function cleanNewInboxMessage() {
+ // Init
+ var mPath = '#inbox .';
+
+ // We reset the forms
+ $(mPath + 'inbox-new-block:not(form) input, ' + mPath + 'inbox-new textarea').val('').removeClass('please-complete');
+ $(mPath + 'inbox-new-file a').remove();
+ $(mPath + 'inbox-new-file input').show();
+
+ // We close an eventual opened message
+ $(mPath + 'message-content').remove();
+ $(mPath + 'one-message').removeClass('message-reading');
+}
+
+// Sends a normal message
+function sendInboxMessage(to, subject, body) {
+ // We send the message
+ var mess = new JSJaCMessage();
+
+ // Main attributes
+ mess.setTo(to);
+ mess.setSubject(subject);
+ mess.setType('normal');
+
+ // Any file to attach?
+ var attached = '#inbox .inbox-new-file a.file';
+
+ if(exists(attached))
+ body += '\n' +
+ '\n' +
+ $(attached).attr('data-attachedtitle') + ' - ' + $(attached).attr('data-attachedhref');
+
+ // Set body
+ mess.setBody(body);
+
+ con.send(mess, handleErrorReply);
+}
+
+// Performs the normal message sender checks
+function checkInboxMessage() {
+ // We get some informations
+ var mPath = '#inbox ';
+ var to = $(mPath + '.inbox-new-to-input').val();
+ var body = $(mPath + '.inbox-new-textarea').val();
+ var subject = $(mPath + '.inbox-new-subject-input').val();
+
+ if(to && body && subject) {
+ // New array of XID
+ var xid = new Array(to);
+
+ // More than one XID
+ if(to.indexOf(',') != -1)
+ xid = to.split(',');
+
+ for(i in xid) {
+ var current = xid[i];
+
+ // No current value?
+ if(!current || current.match(/^(\s+)$/))
+ continue;
+
+ // Edit the XID if needed
+ current = current.replace(/ /g, '');
+ current = generateXID(current, 'chat');
+
+ // We send the message
+ sendInboxMessage(current, subject, body);
+
+ // We clean the inputs
+ cleanNewInboxMessage();
+
+ logThis('Inbox message sent: ' + current, 3);
+ }
+
+ // Close the inbox
+ closeInbox();
+ }
+
+ else {
+ $(mPath + 'input[type=text], ' + mPath + 'textarea').each(function() {
+ var current = this;
+
+ if(!$(current).val()) {
+ $(document).oneTime(10, function() {
+ $(current).addClass('please-complete').focus();
+ });
+ }
+
+ else
+ $(current).removeClass('please-complete');
+ });
+ }
+
+ return false;
+}
+
+// Shows the inbox messages
+function showInboxMessages() {
+ // Init
+ var mPath = '#inbox .';
+
+ // We switch the divs
+ $(mPath + 'inbox-new').hide();
+ $(mPath + 'inbox-results').show();
+
+ // We show a new link in the menu
+ $(mPath + 'a-show-messages').hide();
+ $(mPath + 'a-delete-messages').show();
+ $(mPath + 'a-new-message').show();
+
+ // We reset some stuffs
+ cleanNewInboxMessage();
+
+ return false;
+}
+
+// Displays a normal message
+function displayInboxMessage(from, subject, content, status, id, date) {
+ // Generate some paths
+ var inbox = '#inbox .';
+ var one_message = inbox + 'one-message.' + id;
+
+ // Message yet displayed!
+ if(exists(one_message))
+ return false;
+
+ // Get the nearest element
+ var stamp = extractStamp(Date.jab2date(date));
+ var nearest = sortElementByStamp(stamp, '#inbox .one-message');
+
+ // Get the buddy name
+ var name = getBuddyName(from).htmlEnc();
+
+ // We generate the html code
+ var nContent = '' +
+ '
';
+
+ // Display the message
+ if(nearest == 0)
+ $(inbox + 'inbox-results .inbox').append(nContent);
+ else
+ $('#inbox .one-message[data-stamp=' + nearest + ']:first').before(nContent);
+
+ // Click events
+ $(one_message + ' .message-head').click(function() {
+ if(!exists(one_message + ' .message-content'))
+ revealInboxMessage(id, from, subject, content, name, date, status);
+ else
+ hideInboxMessage(id);
+
+ return false;
+ });
+
+ // Get the user avatar
+ getAvatar(from, 'cache', 'true', 'forget');
+
+ return true;
+}
+
+// Stores an inbox message
+function storeInboxMessage(from, subject, content, status, id, date) {
+ // Initialize the XML data
+ var xml = '' +
+ '
' +
+ '' +
+ '' +
+ '
' +
+
+ '' +
+ '' +
+
+ '' +
+ '' +
+ '' + unread + '
');
+
+ // Update the title
+ updateTitle();
+
+ return true;
+ }
+
+ // Anyway, update the title
+ updateTitle();
+
+ return false;
+}
+
+// Reveal a normal message content
+function revealInboxMessage(id, from, subject, content, name, date, status) {
+ // Message path
+ var all_message = '#inbox .one-message';
+ var one_message = all_message + '.' + id;
+ var one_content = one_message + ' .message-content';
+
+ // We reset all the other messages
+ $(all_message + ' .message-content').remove();
+ $(all_message).removeClass('message-reading');
+
+ // Message content
+ var html =
+ '';
+
+ $(one_message).append(html).addClass('message-reading');
+
+ // Click events
+ $(one_content + ' a.reply').click(function() {
+ return replyInboxMessage(id, from, subject, content);
+ });
+
+ $(one_content + ' a.remove').click(function() {
+ return deleteInboxMessage(id);
+ });
+
+ // Unread message
+ if(status == 'unread') {
+ // Update our database
+ var xml = getDB('inbox', id).replace(/' + _e("Media viewer") + '
' +
+
+ '' +
+
+ '';
+
+ // Create the popup
+ createPopup('integratebox', html);
+
+ // Associate the events
+ launchIntegratebox();
+}
+
+// Closes the integratebox popup
+function closeIntegrateBox() {
+ // Destroy the popup
+ destroyPopup('integratebox');
+
+ return false;
+}
+
+// Generates the integratebox HTML code
+function codeIntegrateBox(serv, url) {
+ var code = '';
+
+ // Protocol to use
+ var protocol = 'http';
+
+ if(isHTTPS())
+ protocol = 'https';
+
+ // Legacy browser
+ var legacy = false;
+
+ if((BrowserDetect.browser == 'Explorer') && (BrowserDetect.version < 9))
+ legacy = true;
+
+ // Switch to get the good DOM code
+ switch(serv) {
+ case 'youtube':
+ if(legacy)
+ code = '';
+ else
+ code = '';
+
+ break;
+
+ case 'dailymotion':
+ code = '';
+
+ break;
+
+ case 'vimeo':
+ code = '';
+
+ break;
+
+ case 'theora':
+ case 'video':
+ code = '';
+
+ break;
+
+ case 'vorbis':
+ case 'audio':
+ code = '';
+
+ break;
+
+ case 'image':
+ code = '' + dom_code + '
');
+
+ // Image waiting icon
+ if(service == 'image') {
+ var waitItem = $('#integratebox .wait');
+
+ // Show it while it is loading
+ waitItem.show();
+
+ // Hide it when it is loaded
+ $('#integratebox img').load(function() {
+ waitItem.hide();
+
+ // Center the image vertically
+ $(this).oneTime(10, function() {
+ $(this).css('margin-top', (($('#integratebox .content').height() - $(this).height()) / 2));
+ });
+ });
+ }
+
+ // Large style?
+ var comments_id = genID();
+
+ if(width_style == 'large') {
+ // Make the popup large
+ $('#integratebox .popup').addClass('large');
+
+ // Add the right content
+ $('#integratebox .content').after(
+ '' +
+ '
'
+ );
+ }
+
+ // Previous and next items?
+ var url_array = stringToArray(url_list);
+ var services_array = stringToArray(services_list);
+ var comments_e_array = stringToArray(comments_e_list);
+ var comments_n_array = stringToArray(comments_n_list);
+ var index = indexArrayValue(url_array, url);
+
+ // Any comments?
+ if(exists('#integratebox .comments')) {
+ if(comments_e_array[index] && comments_n_array[index])
+ getCommentsMicroblog(comments_e_array[index], comments_n_array[index], comments_id);
+ else
+ $('#integratebox .comments .comments-content').html('' +
+ '
' +
+ '' + _e("Loading comments...") + '
' +
+ '' + _e("Comments locked!") + '
');
+ }
+
+ // Get the previous values
+ var previous_url = url_array[index - 1];
+ var previous_services = services_array[index - 1];
+
+ // Get the next values
+ var next_url = url_array[index + 1];
+ var next_services = services_array[index + 1];
+
+ // Enable/disable buttons
+ if(previous_url && previous_services)
+ $('#integratebox .bottom .finish.previous').removeClass('disabled');
+ else
+ $('#integratebox .bottom .finish.previous').addClass('disabled');
+
+ if(next_url && next_services)
+ $('#integratebox .bottom .finish.next').removeClass('disabled');
+ else
+ $('#integratebox .bottom .finish.next').addClass('disabled');
+
+ // Click events
+ $('#integratebox .bottom .finish.previous, #integratebox .bottom .finish.next').click(function() {
+ // Not acceptable?
+ if($(this).is('.disabled'))
+ return false;
+
+ // Apply the event!
+ if($(this).is('.previous'))
+ applyIntegrateBox(previous_url, previous_services, url_list, services_list, comments_e_list, comments_n_list, width_style);
+ else
+ applyIntegrateBox(next_url, next_services, url_list, services_list, comments_e_list, comments_n_list, width_style);
+
+ return false;
+ });
+
+ if(width_style == 'large')
+ $('#integratebox .content a:has(img)').click(function() {
+ if(next_url && next_services)
+ applyIntegrateBox(next_url, next_services, url_list, services_list, comments_e_list, comments_n_list, width_style);
+
+ return false;
+ });
+
+ return false;
+ }
+
+ // Nothing: return true to be able to open the URL in a new tab
+ return true;
+}
+
+// Checks whether the file ext can use integratebox or not
+function canIntegrateBox(ext) {
+ // Can use?
+ if(ext && ((ext == 'jpg') || (ext == 'jpeg') || (ext == 'png') || (ext == 'gif') || (ext == 'ogg') || (ext == 'oga') || (ext == 'ogv')))
+ return true;
+
+ return false;
+}
+
+// Filters a string to apply the integratebox links
+function filterIntegrateBox(data) {
+ // Encapsulates the string into two elements
+ var xml = $('' + data + '
' +
+ '' +
+ '
';
+
+ // Append the HTML code
+ $('body').append(html);
+
+ return true;
+}
+
+// Removes the general-wait item
+function removeGeneralWait() {
+ $('#general-wait').remove();
+}
+
+// Generates a file upload valid form content
+function generateFileShare() {
+ return '' +
+ '' +
+ '' +
+ '' +
+ '' +
+ '';
+}
+
+// Switches to the given chan
+function switchChan(id) {
+ if(exists('#' + id)) {
+ // We show the page-engine content
+ $('.page-engine-chan').hide();
+ $('#' + id).show();
+
+ // We edit the tab switcher
+ $('#page-switch .switcher').removeClass('activechan').addClass('chan');
+ $('#page-switch .' + id).addClass('activechan').removeClass('chan');
+
+ // Scroll down to the last message
+ if(id != 'channel')
+ autoScroll(id);
+
+ // Manage input focus
+ inputFocus();
+ }
+
+ return false;
+}
+
+// Loads the complete chat switcher
+function loadChatSwitch() {
+ // Path
+ var more_content = '#page-switch .more-content';
+
+ // Yet displayed?
+ if(exists(more_content))
+ return closeBubbles();
+
+ // Add the bubble
+ showBubble(more_content);
+
+ // Append the content
+ $('#page-switch .more').append(
+ '' +
+ $('#page-switch .chans').html() +
+ '
'
+ );
+
+ return false;
+}
+
+// Puts the selected smiley in the good page-engine input
+function insertSmiley(smiley, hash) {
+ // We define the variables
+ var selector = $('#' + hash + ' .message-area');
+ var oValue = selector.val();
+
+ // Any old value?
+ if(oValue && !oValue.match(/^(.+)(\s)+$/))
+ oValue += ' ';
+
+ var nValue = oValue + smiley + ' ';
+
+ // Put the new value and focus on it
+ $(document).oneTime(10, function() {
+ selector.val(nValue).focus();
+ });
+
+ return false;
+}
+
+// Deletes all the associated elements of the chat we want to remove
+function deleteThisChat(hash) {
+ $('#' + hash + ', #page-switch .' + hash).remove();
+}
+
+// Closes the given chat
+function quitThisChat(xid, hash, type) {
+ if(type == 'groupchat') {
+ // Send our unavailable presence
+ sendPresence(xid + '/' + getMUCNick(hash), 'unavailable');
+
+ // Remove all presence database entries for this groupchat
+ for(var i = 0; i < sessionStorage.length; i++) {
+ // Get the pointer values
+ var current = sessionStorage.key(i);
+ var cXID = explodeThis('_', current, 1);
+
+ // If the pointer is on a presence from this groupchat
+ if((explodeThis('_', current, 0) == 'presence') && (bareXID(cXID) == xid)) {
+ // Generate the hash for the current XID
+ var cHash = hex_md5(cXID);
+
+ // Disable the message textarea
+ $('#' + cHash + ' .message-area').attr('disabled', true);
+
+ // Remove the presence for this XID
+ removeDB('presence', cXID);
+ presenceFunnel(cXID, cHash);
+ }
+ }
+ }
+
+ else
+ chatStateSend('gone', xid, hash);
+
+ // Get the chat ID which is before
+ var previous = $('#' + hash).prev().attr('id');
+
+ // Remove the chat
+ deleteThisChat(hash);
+
+ // Reset the switcher
+ if(!exists('#page-switch .switcher.activechan'))
+ switchChan(previous);
+
+ // Reset the notifications
+ chanCleanNotify(hash);
+
+ return false;
+}
+
+// Generates the chat logs
+function generateChatLog(xid, hash) {
+ // Get the main values
+ var path = '#' + hash + ' .';
+ var content = $(path + 'content').clone().contents();
+ var avatar = $(path + 'top .avatar-container:first').html();
+ var nick = $(path + 'top .bc-name').text();
+ var date = getXMPPTime('local');
+ var type = $('#' + hash).attr('data-type');
+
+ // Filter the content smileys
+ $(content).find('img.emoticon').each(function() {
+ $(this).replaceWith($(this).attr('alt'));
+ });
+
+ // Remove the useless attributes
+ $(content).removeAttr('data-type').removeAttr('data-stamp');
+
+ // Remove the content avatars
+ $(content).find('.avatar-container').remove();
+
+ // Remove the content click events
+ $(content).find('a').removeAttr('onclick');
+
+ // Extract the content HTML code
+ content = $(content).parent().html();
+
+ // No avatar?
+ if(!avatar || !avatar.match(/data:/))
+ avatar = 'none';
+
+ // POST the values to the server
+ $.post('./php/generate-chat.php', { content: content, xid: xid, nick: nick, avatar: avatar, date: date, type: type }, function(data) {
+ // Handled!
+ $(path + 'tooltip-waitlog').replaceWith('' + _e("Download file!") + '');
+ });
+
+ return false;
+}
+
+// Notifies the user from a new incoming message
+function messageNotify(hash, type) {
+ // Initialize the vars
+ var chat_switch = '#page-switch .';
+ var tested = chat_switch + hash;
+ var active = $(tested).hasClass('activechan');
+
+ // We notify the user if he has not the focus on the chat
+ if(!active || !isFocused()) {
+ if(!active) {
+ if(type == 'personnal')
+ $(tested + ', ' + chat_switch + 'more-button').addClass('chan-newmessage');
+ else if(type == 'unread')
+ $(tested).addClass('chan-unread');
+ }
+
+ // Count the number of pending messages
+ var pending = 1;
+
+ if(exists('#' + hash + '[data-counter]'))
+ pending = parseInt($('#' + hash).attr('data-counter')) + 1;
+
+ $('#' + hash).attr('data-counter', pending);
+ }
+
+ // Update the page title
+ updateTitle();
+}
+
+// Returns the number of pending events
+function pendingEvents() {
+ // Count the number of notifications
+ var number = 0;
+
+ $('.one-counter[data-counter]').each(function() {
+ number = number + parseInt($(this).attr('data-counter'));
+ });
+
+ return number;
+}
+
+// Updates the page title
+function updateTitle() {
+ // Any pending events?
+ if(exists('.one-counter[data-counter]'))
+ pageTitle('new');
+ else
+ pageTitle('talk');
+}
+
+// Cleans the given chat notifications
+function chanCleanNotify(hash) {
+ // We remove the class that tell the user of a new message
+ var chat_switch = '#page-switch .';
+ $(chat_switch + hash).removeClass('chan-newmessage chan-unread');
+
+ // We reset the global notifications if no more unread messages
+ if(!$(chat_switch + 'chans .chan-newmessage').size())
+ $(chat_switch + 'more-button').removeClass('chan-newmessage');
+
+ // We reset the chat counter
+ $('#' + hash).removeAttr('data-counter');
+
+ // Update the page title
+ updateTitle();
+}
+
+// Scrolls to the last chat message
+function autoScroll(hash) {
+ // Avoid a JS error
+ if(exists('#' + hash)) {
+ var container = document.getElementById('chat-content-' + hash);
+
+ // Scroll down!
+ container.scrollTop = container.scrollHeight;
+ }
+}
+
+// Shows all the buddies in the buddy-list
+function showAllBuddies(from) {
+ // Put a marker
+ BLIST_ALL = true;
+
+ // We switch the two modes
+ $('.buddy-conf-more-display-unavailable').hide();
+ $('.buddy-conf-more-display-available').show();
+
+ // Security: reset all the groups toggle event
+ $('#buddy-list .group-buddies').show();
+ $('#buddy-list .group span').text('-');
+
+ // We show the disconnected buddies
+ $('.hidden-buddy').show();
+
+ // We show all the groups
+ $('#buddy-list .one-group').show();
+
+ if(SEARCH_FILTERED)
+ funnelFilterBuddySearch();
+
+ // Store this in the options
+ if((from == 'roster') && loadedOptions()) {
+ setDB('options', 'roster-showall', '1');
+ storeOptions();
+ }
+}
+
+// Shows only the online buddies in the buddy-list
+function showOnlineBuddies(from) {
+ // Remove the marker
+ BLIST_ALL = false;
+
+ // We switch the two modes
+ $('.buddy-conf-more-display-available').hide();
+ $('.buddy-conf-more-display-unavailable').show();
+
+ // Security: reset all the groups toggle event
+ $('#buddy-list .group-buddies').show();
+ $('#buddy-list .group span').text('-');
+
+ // We hide the disconnected buddies
+ $('.hidden-buddy').hide();
+
+ // We check the groups to hide
+ updateGroups();
+
+ if(SEARCH_FILTERED)
+ funnelFilterBuddySearch();
+
+ // Store this in the options
+ if((from == 'roster') && loadedOptions()) {
+ setDB('options', 'roster-showall', '0');
+ storeOptions();
+ }
+}
+
+// Focuses on the right input
+function inputFocus() {
+ // No popup shown
+ if(!exists('.popup'))
+ $(document).oneTime(10, function() {
+ $('.focusable:visible:first').focus();
+ });
+}
+
+// Plugin launcher
+function launchInterface() {
+ // Focus on the first visible input
+ $(window).focus(inputFocus);
+}
+
+// Launch this plugin!
+$(document).ready(launchInterface);
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/iq.js b/sources/extend/addon/matrix/jappixmini/jappix/js/iq.js
new file mode 100644
index 00000000..1e16292e
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/iq.js
@@ -0,0 +1,193 @@
+/*
+
+Jappix - An open social platform
+These are the IQ JS scripts for Jappix
+
+-------------------------------------------------
+
+License: AGPL
+Author: Vanaryon
+Last revision: 27/08/11
+
+*/
+
+// Handles an incoming IQ packet
+function handleIQ(iq) {
+ // Gets the IQ content
+ var iqNode = iq.getNode();
+ var iqFrom = fullXID(getStanzaFrom(iq));
+ var iqID = iq.getID();
+ var iqQueryXMLNS = iq.getQueryXMLNS();
+ var iqQuery = iq.getQuery();
+ var iqType = iq.getType();
+
+ // Build the response
+ var iqResponse = new JSJaCIQ();
+
+ iqResponse.setID(iqID);
+ iqResponse.setTo(iqFrom);
+ iqResponse.setType('result');
+
+ // OOB request
+ if((iqQueryXMLNS == NS_IQOOB) && (iqType == 'set')) {
+ /* REF: http://xmpp.org/extensions/xep-0066.html */
+
+ handleOOB(iqFrom, iqID, 'iq', iqNode);
+
+ logThis('Received IQ OOB request: ' + iqFrom);
+ }
+
+ // OOB reply
+ else if(getDB('send/url', iqID)) {
+ // Get the values
+ var oob_url = getDB('send/url', iqID);
+ var oob_desc = getDB('send/desc', iqID);
+ var notif_id = hex_md5(oob_url + oob_desc + iqType + iqFrom + iqID);
+
+ // Error?
+ if($(iqNode).find('error').size()) {
+ // Rejected?
+ if($(iqNode).find('error not-acceptable').size())
+ newNotification('send_reject', iqFrom, [iqFrom, oob_url, 'iq', iqID, iqNode], oob_desc, notif_id);
+
+ // Failed?
+ else
+ newNotification('send_fail', iqFrom, [iqFrom, oob_url, 'iq', iqID, iqNode], oob_desc, notif_id);
+
+ // Remove the file
+ $.get(oob_url + '&action=remove');
+ }
+
+ // Success?
+ else if(iqType == 'result')
+ newNotification('send_accept', iqFrom, [iqFrom, oob_url, 'iq', iqID, iqNode], oob_desc, notif_id);
+ }
+
+ // Software version query
+ else if((iqQueryXMLNS == NS_VERSION) && (iqType == 'get')) {
+ /* REF: http://xmpp.org/extensions/xep-0092.html */
+
+ var iqQuery = iqResponse.setQuery(NS_VERSION);
+
+ iqQuery.appendChild(iq.buildNode('name', {'xmlns': NS_VERSION}, 'Jappix'));
+ iqQuery.appendChild(iq.buildNode('version', {'xmlns': NS_VERSION}, JAPPIX_VERSION));
+ iqQuery.appendChild(iq.buildNode('os', {'xmlns': NS_VERSION}, BrowserDetect.OS));
+
+ con.send(iqResponse);
+
+ logThis('Received software version query: ' + iqFrom);
+ }
+
+ // Last activity query
+ else if((iqQueryXMLNS == NS_LAST) && (iqType == 'get')) {
+ /* REF: http://xmpp.org/extensions/xep-0012.html */
+
+ var iqQuery = iqResponse.setQuery(NS_LAST);
+ iqQuery.setAttribute('seconds', getLastActivity());
+
+ con.send(iqResponse);
+
+ logThis('Received last activity query: ' + iqFrom);
+ }
+
+ // Privacy lists push
+ else if((iqQueryXMLNS == NS_PRIVACY) && (iqType == 'set')) {
+ // REF : http://xmpp.org/extensions/xep-0016.html
+
+ // Roster push
+ con.send(iqResponse);
+
+ // Get the lists
+ $(iqQuery).find('list').each(function() {
+ getPrivacy($(this).attr('name'));
+ });
+
+ logThis('Received privacy lists push: ' + iqFrom);
+ }
+
+ // Roster push
+ else if((iqQueryXMLNS == NS_ROSTER) && (iqType == 'set')) {
+ // REF : http://xmpp.org/extensions/xep-0092.html
+
+ // Roster push
+ con.send(iqResponse);
+
+ // Get the values
+ $(iqQuery).find('item').each(function() {
+ parseRoster($(this), 'presence');
+ });
+
+ logThis('Received roster push: ' + iqFrom);
+ }
+
+ // Roster Item Exchange query
+ else if($(iqNode).find('x[xmlns=' + NS_ROSTERX + ']').size()) {
+ // Open a new notification
+ newNotification('rosterx', iqFrom, [iqNode], '');
+
+ logThis('Roster Item Exchange from: ' + iqFrom);
+ }
+
+ // Disco info query
+ else if((iqQueryXMLNS == NS_DISCO_INFO) && (iqType == 'get')) {
+ /* REF: http://xmpp.org/extensions/xep-0030.html */
+
+ var iqQuery = iqResponse.setQuery(NS_DISCO_INFO);
+
+ // We set the name of the client
+ iqQuery.appendChild(iq.buildNode('identity', {
+ 'category': 'client',
+ 'type': 'web',
+ 'name': 'Jappix',
+ 'xmlns': NS_DISCO_INFO
+ }));
+
+ // We set all the supported features
+ var fArray = myDiscoInfos();
+
+ for(i in fArray)
+ iqQuery.appendChild(iq.buildNode('feature', {'var': fArray[i], 'xmlns': NS_DISCO_INFO}));
+
+ con.send(iqResponse);
+
+ logThis('Received disco#infos query: ' + iqFrom);
+ }
+
+ // User time query
+ else if($(iqNode).find('time').size() && (iqType == 'get')) {
+ /* REF: http://xmpp.org/extensions/xep-0202.html */
+
+ var iqTime = iqResponse.appendNode('time', {'xmlns': NS_URN_TIME});
+ iqTime.appendChild(iq.buildNode('tzo', {'xmlns': NS_URN_TIME}, getDateTZO()));
+ iqTime.appendChild(iq.buildNode('utc', {'xmlns': NS_URN_TIME}, getXMPPTime('utc')));
+
+ con.send(iqResponse);
+
+ logThis('Received local time query: ' + iqFrom);
+ }
+
+ // Ping
+ else if($(iqNode).find('ping').size() && (iqType == 'get')) {
+ /* REF: http://xmpp.org/extensions/xep-0199.html */
+
+ con.send(iqResponse);
+
+ logThis('Received a ping: ' + iqFrom);
+ }
+
+ // Not implemented
+ else if(!$(iqNode).find('error').size() && ((iqType == 'get') || (iqType == 'set'))) {
+ // Append stanza content
+ for(var i = 0; i < iqNode.childNodes.length; i++)
+ iqResponse.getNode().appendChild(iqNode.childNodes.item(i).cloneNode(true));
+
+ // Append error content
+ var iqError = iqResponse.appendNode('error', {'xmlns': NS_CLIENT, 'code': '501', 'type': 'cancel'});
+ iqError.appendChild(iq.buildNode('feature-not-implemented', {'xmlns': NS_STANZAS}));
+ iqError.appendChild(iq.buildNode('text', {'xmlns': NS_STANZAS}, _e("The feature requested is not implemented by the recipient or server and therefore cannot be processed.")));
+
+ con.send(iqResponse);
+
+ logThis('Received an unsupported IQ query from: ' + iqFrom);
+ }
+}
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/js/jquery.datepicker.js b/sources/extend/addon/matrix/jappixmini/jappix/js/jquery.datepicker.js
new file mode 100644
index 00000000..d4786f90
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/js/jquery.datepicker.js
@@ -0,0 +1,896 @@
+/*
+
+Jappix - An open social platform
+These are the datepicker JS script
+
+-------------------------------------------------
+
+Licenses: MIT, GPL, AGPL
+Authors: Stefan Petre, Vanaryon
+Last revision: 19/12/10
+
+*/
+
+(function ($) {
+ var DatePicker = function () {
+ var ids = {},
+ views = {
+ years: 'datepickerViewYears',
+ moths: 'datepickerViewMonths',
+ days: 'datepickerViewDays'
+ },
+ tpl = {
+ wrapper: '| <%=prev%> | ', + '', + ' | <%=next%> | ', + '|||||
|---|---|---|---|---|---|---|---|
| <%=week%> | ', + '<%=day1%> | ', + '<%=day2%> | ', + '<%=day3%> | ', + '<%=day4%> | ', + '<%=day5%> | ', + '<%=day6%> | ', + '<%=day7%> | ', + '
| t |
Forbidden
+This is a private folder
+ + +'; +} + +// Checks if a relative server path is safe +function isSafe($path) { + // Mhh, someone is about to nasty stuffs (previous folder, or executable scripts) + if(preg_match('/\.\.\//', $path) || preg_match('/index\.html?$/', $path) || preg_match('/(\.)((php([0-9]+)?)|(aspx?)|(cgi)|(rb)|(py)|(pl)|(jsp)|(ssjs)|(lasso)|(dna)|(tpl)|(smx)|(cfm))$/i', $path)) + return false; + + return true; +} + +// Set the good unity for a size in bytes +function formatBytes($bytes, $precision = 2) { + $units = array('B', 'KB', 'MB', 'GB', 'TB'); + + $bytes = max($bytes, 0); + $pow = floor(($bytes ? log($bytes) : 0) / log(1024)); + $pow = min($pow, count($units) - 1); + + $bytes /= pow(1024, $pow); + + return round($bytes, $precision) . ' ' . $units[$pow]; +} + +// Converts a human-readable bytes value to a computer one +function humanToBytes($string) { + // Values array + $values = array( + 'K' => '000', + 'M' => '000000', + 'G' => '000000000', + 'T' => '000000000000', + 'P' => '000000000000000', + 'E' => '000000000000000000', + 'Z' => '000000000000000000000', + 'Y' => '000000000000000000000000' + ); + + // Filter the string + foreach($values as $key => $zero) + $string = str_replace($key, $zero, $string); + + // Converts the string into an integer + $string = intval($string); + + return $string; +} + +// Get the maximum file upload size +function uploadMaxSize() { + // Not allowed to upload files? + if(ini_get('file_uploads') != 1) + return 0; + + // Upload maximum file size + $upload = humanToBytes(ini_get('upload_max_filesize')); + + // POST maximum size + $post = humanToBytes(ini_get('post_max_size')); + + // Return the lowest value + if($upload <= $post) + return $upload; + + return $post; +} + +// Normalizes special chars +function normalizeChars($string) { + $table = array( + 'Å '=>'S', 'Å¡'=>'s', 'Ä'=>'Dj', 'Ä‘'=>'dj', 'Ž'=>'Z', 'ž'=>'z', 'ÄŒ'=>'C', 'Ä'=>'c', 'Ć'=>'C', 'ć'=>'c', + 'À'=>'A', 'Ã'=>'A', 'Â'=>'A', 'Ã'=>'A', 'Ä'=>'A', 'Ã…'=>'A', 'Æ'=>'A', 'Ç'=>'C', 'È'=>'E', 'É'=>'E', + 'Ê'=>'E', 'Ë'=>'E', 'ÃŒ'=>'I', 'Ã'=>'I', 'ÃŽ'=>'I', 'Ã'=>'I', 'Ñ'=>'N', 'Ã’'=>'O', 'Ó'=>'O', 'Ô'=>'O', + 'Õ'=>'O', 'Ö'=>'O', 'Ø'=>'O', 'Ù'=>'U', 'Ú'=>'U', 'Û'=>'U', 'Ãœ'=>'U', 'Ã'=>'Y', 'Þ'=>'B', 'ß'=>'Ss', + 'à '=>'a', 'á'=>'a', 'â'=>'a', 'ã'=>'a', 'ä'=>'a', 'Ã¥'=>'a', 'æ'=>'a', 'ç'=>'c', 'è'=>'e', 'é'=>'e', + 'ê'=>'e', 'ë'=>'e', 'ì'=>'i', 'Ã'=>'i', 'î'=>'i', 'ï'=>'i', 'ð'=>'o', 'ñ'=>'n', 'ò'=>'o', 'ó'=>'o', + 'ô'=>'o', 'õ'=>'o', 'ö'=>'o', 'ø'=>'o', 'ù'=>'u', 'ú'=>'u', 'û'=>'u', 'ý'=>'y', 'ý'=>'y', 'þ'=>'b', + 'ÿ'=>'y', 'Å”'=>'R', 'Å•'=>'r' + ); + + return strtr($string, $table); +} + +// Filters the XML special chars for the SVG drawer +function filterSpecialXML($string) { + // Strange thing: when $string = 'Mises à jour' -> bug! but 'Mise à jour' -> ok! + $string = normalizeChars($string); + + // Encodes with HTML special chars + $string = htmlspecialchars($string); + + return $string; +} + +// Writes the current visit in the total file +function writeTotalVisit() { + // Get the current time stamp + $stamp = time(); + + // Initialize the defaults + $array = array( + 'total' => 0, + 'stamp' => $stamp + ); + + // Try to read the saved data + $total_data = readXML('access', 'total'); + + // Get the XML file values + if($total_data) { + // Initialize the visits reading + $read_xml = new SimpleXMLElement($total_data); + + // Loop the visit elements + foreach($read_xml->children() as $current_child) + $array[$current_child->getName()] = intval($current_child); + } + + // Increment the total number of visits + $array['total']++; + + // Generate the new XML data + $total_xml = + '
+
+ '.$original.'
+
+
+'
+;
+
+ $new_text = stripslashes($new_text_inter);
+
+ // Write the code into a file
+ file_put_contents($filepath, $new_text);
+
+ // Security: remove the file and stop the script if too bit (+6MiB)
+ if(filesize($filepath) > 6000000) {
+ unlink($filepath);
+ exit;
+ }
+
+ // Return to the user the generated file ID
+ exit($filename);
+}
+
+?>
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/php/geolocation.php b/sources/extend/addon/matrix/jappixmini/jappix/php/geolocation.php
new file mode 100644
index 00000000..acfdedbc
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/php/geolocation.php
@@ -0,0 +1,43 @@
+
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/php/get-store.php b/sources/extend/addon/matrix/jappixmini/jappix/php/get-store.php
new file mode 100644
index 00000000..ce754b18
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/php/get-store.php
@@ -0,0 +1,37 @@
+
+
+
+
+
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/php/get.php b/sources/extend/addon/matrix/jappixmini/jappix/php/get.php
new file mode 100644
index 00000000..f3a1c124
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/php/get.php
@@ -0,0 +1,338 @@
+$type;
+
+ // Files were added to the list before (with file var)?
+ if($file)
+ $file .= '~'.$xml_parse;
+ else
+ $file = $xml_parse;
+ }
+}
+
+// We check if the data was submitted
+if($file && $type) {
+ // We define some stuffs
+ $dir = '../'.$type.'/';
+ $path = $dir.$file;
+
+ // Define the real type if this is a "store" file
+ if($type == 'store') {
+ // Extract the file extension
+ switch(getFileExt($file)) {
+ // CSS file
+ case 'css':
+ $type = 'css';
+
+ break;
+
+ // JS file
+ case 'js':
+ $type = 'js';
+
+ break;
+
+ // Audio file
+ case 'ogg':
+ case 'oga':
+ $type = 'snd';
+
+ break;
+
+ // Image file
+ case 'png':
+ case 'jpg':
+ case 'jpeg':
+ case 'gif':
+ case 'bmp':
+ $type = 'img';
+
+ break;
+ }
+ }
+
+ // JS and CSS special stuffs
+ if(($type == 'css') || ($type == 'js')) {
+ // Compression var
+ if($has_compression)
+ $cache_encoding = 'deflate';
+ else
+ $cache_encoding = 'plain';
+
+ // Get the vars
+ $version = getVersion();
+ $hash = genHash($version);
+ $cache_hash = md5($path.$hash.staticLocation()).'_'.$cache_encoding;
+
+ // Check if the browser supports DEFLATE
+ $deflate_support = false;
+
+ if(isset($_SERVER['HTTP_ACCEPT_ENCODING']) && substr_count($_SERVER['HTTP_ACCEPT_ENCODING'], 'deflate') && hasCompression() && !$is_developer)
+ $deflate_support = true;
+
+ // Internationalization
+ if($type == 'js') {
+ if(isset($_GET['l']) && !empty($_GET['l']) && !preg_match('/\.\.\//', $_GET['l']) && is_dir('../lang/'.$_GET['l']))
+ $locale = $_GET['l'];
+ else
+ $locale = 'en';
+ }
+
+ else
+ $locale = '';
+
+ // Define the cache lang name
+ if($locale)
+ $cache_lang = $cache_hash.'_'.$locale;
+ else
+ $cache_lang = $cache_hash;
+ }
+
+ // Explode the file string
+ if(strpos($file, '~') != false)
+ $array = explode('~', $file);
+ else
+ $array = array($file);
+
+ // Define the reading vars
+ $continue = true;
+ $loop_files = true;
+
+ // Check the cache exists for text files (avoid the heavy file_exists loop!)
+ if(!$is_developer && (($type == 'css') || ($type == 'js')) && hasCache($cache_lang))
+ $loop_files = false;
+
+ // Check if the all the file(s) exist(s)
+ if($loop_files) {
+ foreach($array as $current) {
+ // Stop the loop if a file is missing
+ if(!file_exists($dir.$current)) {
+ $continue = false;
+
+ break;
+ }
+ }
+ }
+
+ // We can read the file(s)
+ if($continue) {
+ // We get the file MIME type
+ $mime = strtolower(preg_replace('/(^)(.+)(\.)(.+)($)/i', '$4', $file));
+
+ // We set up a known MIME type (and some other headers)
+ if(($type == 'css') || ($type == 'js')) {
+ // DEFLATE header
+ if($deflate_support)
+ header('Content-Encoding: deflate');
+
+ // MIME header
+ if($type == 'css')
+ header('Content-Type: text/css; charset=utf-8');
+ else if($type == 'js')
+ header('Content-Type: application/javascript; charset=utf-8');
+ }
+
+ else if($mime == 'png')
+ header('Content-Type: image/png');
+ else if($mime == 'gif')
+ header('Content-Type: image/gif');
+ else if(($mime == 'jpg') || ($mime == 'jpeg'))
+ header('Content-Type: image/jpeg');
+ else if($mime == 'bmp')
+ header('Content-Type: image/bmp');
+ else if(($mime == 'oga') || ($mime == 'ogg'))
+ header('Content-Type: audio/ogg');
+
+ // Catch the file MIME type
+ else
+ header('Content-Type: '.getFileMIME($path));
+
+ // Read the text file(s) (CSS & JS)
+ if(($type == 'css') || ($type == 'js')) {
+ // If there's a cache file, read it
+ if(hasCache($cache_lang) && !$is_developer) {
+ $cache_read = readCache($cache_lang);
+
+ if($deflate_support || !$has_compression)
+ echo $cache_read;
+ else
+ echo gzinflate($cache_read);
+ }
+
+ // Else, we generate the cache
+ else {
+ // First try to read the cache reference
+ if(hasCache($cache_hash) && !$is_developer) {
+ // Read the reference
+ $cache_reference = readCache($cache_hash);
+
+ // Filter the cache reference
+ if($has_compression)
+ $output = gzinflate($cache_reference);
+ else
+ $output = $cache_reference;
+ }
+
+ // No cache reference, we should generate it
+ else {
+ // Initialize the loop
+ $looped = '';
+
+ // Add the content of the current file
+ foreach($array as $current)
+ $looped .= rmBOM(file_get_contents($dir.$current))."\n";
+
+ // Filter the CSS
+ if($type == 'css') {
+ // Apply the CSS logos
+ $looped = setLogos($looped, $array);
+
+ // Apply the CSS background
+ $looped = setBackground($looped);
+
+ // Set the Get API paths
+ $looped = setPath($looped, $hash, HOST_STATIC, $type, '');
+ }
+
+ // Optimize the code rendering
+ if($type == 'css') {
+ // Can minify the CSS
+ if($has_compression && !$is_developer)
+ $output = compressCSS($looped);
+ else
+ $output = $looped;
+ }
+
+ else {
+ // Can minify the JS (sloooooow!)
+ if($has_compression && !$is_developer) {
+ require_once('./jsmin.php');
+ $output = JSMin::minify($looped);
+ }
+
+ else
+ $output = $looped;
+ }
+
+ // Generate the reference cache
+ if($has_compression)
+ $final = gzdeflate($output, 9);
+ else
+ $final = $output;
+
+ // Write it!
+ genCache($final, $is_developer, $cache_hash);
+ }
+
+ // Filter the JS
+ if($type == 'js') {
+ // Set the JS locales
+ $output = setLocales($output, $locale);
+
+ // Set the JS configuration
+ $output = setConfiguration($output, $locale, $version, uploadMaxSize());
+
+ // Set the Get API paths
+ $output = setPath($output, $hash, HOST_STATIC, $type, $locale);
+
+ // Translate the JS script
+ require_once('./gettext.php');
+ includeTranslation($locale, 'main');
+ $output = setTranslation($output);
+
+ // Generate the cache
+ if($has_compression)
+ $final = gzdeflate($output, 9);
+ else
+ $final = $output;
+
+ // Write it!
+ genCache($final, $is_developer, $cache_lang);
+ }
+
+ // Output a well-encoded string
+ if($deflate_support || !$has_compression)
+ echo $final;
+ else
+ echo gzinflate($final);
+ }
+ }
+
+ // Read the binary file (PNG, OGA and others)
+ else
+ readfile($path);
+
+ exit;
+ }
+
+ // The file was not found
+ header('Status: 404 Not Found', true, 404);
+ exit('HTTP/1.1 404 Not Found');
+}
+
+// The request is not correct
+header('Status: 400 Bad Request', true, 400);
+exit('HTTP/1.1 400 Bad Request');
diff --git a/sources/extend/addon/matrix/jappixmini/jappix/php/gettext.php b/sources/extend/addon/matrix/jappixmini/jappix/php/gettext.php
new file mode 100644
index 00000000..f04b77d0
--- /dev/null
+++ b/sources/extend/addon/matrix/jappixmini/jappix/php/gettext.php
@@ -0,0 +1,949 @@
+.
+
+ This file is part of PHP-gettext.
+
+ PHP-gettext is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ PHP-gettext is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with PHP-gettext; if not, write to the Free Software
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+*/
+
+/**
+ * MODIFIED FOR THE JAPPIX PROJECT
+ * Last revision: 10/11/10
+ */
+
+ // Simple class to wrap file streams, string streams, etc.
+ // seek is essential, and it should be byte stream
+class StreamReader {
+ // should return a string [FIXME: perhaps return array of bytes?]
+ function read($bytes) {
+ return false;
+ }
+
+ // should return new position
+ function seekto($position) {
+ return false;
+ }
+
+ // returns current position
+ function currentpos() {
+ return false;
+ }
+
+ // returns length of entire stream (limit for seekto()s)
+ function length() {
+ return false;
+ }
+};
+
+class StringReader {
+ var $_pos;
+ var $_str;
+
+ function StringReader($str='') {
+ $this->_str = $str;
+ $this->_pos = 0;
+ }
+
+ function read($bytes) {
+ $data = substr($this->_str, $this->_pos, $bytes);
+ $this->_pos += $bytes;
+ if (strlen($this->_str)<$this->_pos)
+ $this->_pos = strlen($this->_str);
+
+ return $data;
+ }
+
+ function seekto($pos) {
+ $this->_pos = $pos;
+ if (strlen($this->_str)<$this->_pos)
+ $this->_pos = strlen($this->_str);
+ return $this->_pos;
+ }
+
+ function currentpos() {
+ return $this->_pos;
+ }
+
+ function length() {
+ return strlen($this->_str);
+ }
+
+};
+
+
+class FileReader {
+ var $_pos;
+ var $_fd;
+ var $_length;
+
+ function FileReader($filename) {
+ if (file_exists($filename)) {
+
+ $this->_length=filesize($filename);
+ $this->_pos = 0;
+ $this->_fd = fopen($filename,'rb');
+ if (!$this->_fd) {
+ $this->error = 3; // Cannot read file, probably permissions
+ return false;
+ }
+ } else {
+ $this->error = 2; // File doesn't exist
+ return false;
+ }
+ }
+
+ function read($bytes) {
+ if ($bytes) {
+ fseek($this->_fd, $this->_pos);
+
+ // PHP 5.1.1 does not read more than 8192 bytes in one fread()
+ // the discussions at PHP Bugs suggest it's the intended behaviour
+ $data = '';
+ while ($bytes > 0) {
+ $chunk = fread($this->_fd, $bytes);
+ $data .= $chunk;
+ $bytes -= strlen($chunk);
+ }
+ $this->_pos = ftell($this->_fd);
+
+ return $data;
+ } else return '';
+ }
+
+ function seekto($pos) {
+ fseek($this->_fd, $pos);
+ $this->_pos = ftell($this->_fd);
+ return $this->_pos;
+ }
+
+ function currentpos() {
+ return $this->_pos;
+ }
+
+ function length() {
+ return $this->_length;
+ }
+
+ function close() {
+ fclose($this->_fd);
+ }
+
+};
+
+// Preloads entire file in memory first, then creates a StringReader
+// over it (it assumes knowledge of StringReader internals)
+class CachedFileReader extends StringReader {
+ function CachedFileReader($filename) {
+ if (file_exists($filename)) {
+
+ $length=filesize($filename);
+ $fd = fopen($filename,'rb');
+
+ if (!$fd) {
+ $this->error = 3; // Cannot read file, probably permissions
+ return false;
+ }
+ $this->_str = fread($fd, $length);
+ fclose($fd);
+
+ } else {
+ $this->error = 2; // File doesn't exist
+ return false;
+ }
+ }
+};
+
+/*
+ Copyright (c) 2003, 2009 Danilo Segan