From: Palmira Date: Wed, 17 Aug 2011 13:49:31 +0000 (+0400) Subject: initial commit X-Git-Url: https://vcs.maemo.org/git/?p=mysocials;a=commitdiff_plain;h=c8fa673993d26efdebfcfc797cd9bfe2b06e18e5 initial commit --- diff --git a/www/api.html b/www/api.html new file mode 100644 index 0000000..fb32816 --- /dev/null +++ b/www/api.html @@ -0,0 +1,808 @@ + + + + +MySocials Project + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + +
MySocials API|Privacy|Development|Downloads
+ + + + + + + + + + + + +
+ + + +
+

MySocials API

+

MySocials driver API

+

MySocials driver is provided as a shared library (libmsa<service_name>.so). Structure msa_module *d includes information about the driver (name, identifier, pointers to driver functions). This structure is filled during initialization of the driver. +

+

Driver interface

+

Driver interface is described in file interface.h and consists of 4 functions: +

    +
  • msa_module_init(struct msa_module* d) — driver initialization;
    • +
  • msa_module_get_info(struct msa_module* d) — getting information about driver;
    • +
  • msa_module->send(xmlDocPtr request, xmlDocPtr* response, const struct msa_module* info) — request sending and response receiveing;
    • +
  • msa_module->shutdown(const struct msa_module*) - driver shutdown.
    • +
+ +

Driver initialization and shutting down

+ Driver initialization is performed by using msa_module_init(struct msa_module* d) function. Instance of structure which stores profile setting is created during initialization. Parameter d stores identifier of this instance. +
+ Function msa_module->shutdown(const struct msa_module*) is used during program termination. + +

Interaction with driver

+ + Fuction msa_module->send(xmlDocPtr request, xmlDocPtr* response, const struct msa_module* info) is used to perform requests to the driver. +Parameter request is a request in XML format. Description of structure of sending and receiveing data is described here. +Parameter response contains driver response in XML format. +Function msa_module_get_info(struct msa_module* d) is used to get information about driver (driver name and icon). +

+ +

MySocials driver data structures

+ +

Here you can see description of data structures which are used by MySocials driver. These structures are declared in mysocials_driver.h file which is available for other applications from mysocials-dev package. + +

Enumerations

+

Error codes

+ 
enum error_type {
+	FAILURE, // Function finished with error
+	SUCCESS, // Function finished without error
+	ERROR_ALLOCATION_OF_MEMORY, // Allocation of memory
+     	ERROR_NO_FUNCTION, // Defining function error
+     	ERROR_INITIALIZATION_ALREADY_PASSED, // Re-initialization error
+     	ERROR_IS_BUSY, // Module is busy
+     	ERROR_SEND_DATA, // Data sending error
+     	ERROR_PARSE_DATA // Data parsing error
+}
+
+ +

Driver interface

+

MySocials driver interface described in msa_module structure. Some of the fields of this stucture are filled before initialization by application (marked with **), the rest of it is filled during initialization.

+ 
+	struct msa_module {
+	gchar *id;    // Identifier 
+   	gchar *name;  // External driver name
+   	gchar* driverName;       // Driver name for system purposes (equals driver identifier)
+   	gchar *pic;   // Icon coded in base64
+   	gchar *proxy;  // **Proxy server address or NULL
+   	gint port; // **Proxy server port
+   
+   	/* Pointer to function for processing requests.
+      	   Parameters:
+           xmlRequest — request in XML format
+           xmlResponse — response in XML format
+           info — structure with driver settings
+      
+	   Function returns  SUCCESS in case without errors, otherwise FAILURE. 
+   	*/
+   
+   	error_type (*send)(char* xmlRequest, char** xmlResponse, struct msa_module *info) 
+        
+   	/* Pointer to function for driver shutting down.
+           Parameters:
+           info — structure with driver settings
+      
+	   Function returns  SUCCESS in case without errors, otherwise FAILURE. 
+   	*/
+
+   	error_type (*shutdown)(struct msa_module* info);
+}
+
+
+ +

Format of XML requests and responses

+

Common format of driver request and response

+

Request format

+ 
+	<Request class="" function="" noAuthorize="true">
+      		<Params>
+
+        	</Params>
+	</Request>
+
+ +
    +
  • noAuthorize - flag which forbids driver to call WebAuth (optional, set to false by default)
    • +
  • class - class which includes called function
    • +
  • function - name of the function
    • +
  • Params - set of parameters, stricly defined for each function
    • +
+ +

Response format

+ 
+	<Response class="" function="" authorized="true" upload="..." download="...">
+      		<Params>
+
+        	</Params>
+	</Response>
+
+ +
    +
  • authorized - flag which indicates authorization during request performing (flag isn't set if error occures during request performing)
    • +
  • upload - number of bytes sent to server
    • +
  • download - number of bytes received from server
    • +
+ +

Following classes are supported: +

    +
  • settings: class for working with settings
    • +
  • profile: class for receiving data about user's profile
    • +
  • friends: class for receiving data about user's friends
    • +
  • messages: class for receiving data about messages
    • +
  • photos: class for working with photos
    • +
  • audio: class for working with audio files
    • +
  • video: class for working with video files
    • +
  • news: class for working with news
    • +
+

+ +

Settings

+

getSettings

+ Request: + 
+	<Request class="settings" function="getSettings">
+      		<Params/>
+        </Request>
+
+ + Response: + 
+	<Response class="settings" function="getSettings">
+      		<Params>
+			<string name="mid"> ... </string>
+			<string name="sid"> ... </string>
+			<string name="secret"> ... </string>
+        	</Params>
+	</Response>
+
+

Content of Params tag depends on the driver. It is recommended to save content of Params tag and send it to setup function without any changes.

+ +

setSettings

+ Request: + 
+	<Request class="settings" function="setSettings">
+      		<Params>
+			<string name="mid"> ... </string>
+			<string name="sid"> ... </string>
+			<string name="secret"> ... </string>
+        	</Params>
+	</Request>
+
+

Params tag must contain data received from driver during getSettings request.

+ Response: info message or error message. + +

getListMethods

+ Request: + 
+	<Request class="settings" function="getListMethods">
+      		<Params/>
+        </Request>
+
+ Response: + 
+	<Response class="settings" function="getListMethods">
+      		<Params>
+			<string function="..." class="..."> ... </string>
+			<string function="..." class="..."> ... </string>
+			...
+        	</Params>
+	</Response>
+
+ +

testConnection

+ Request: + 
+	<Request class="settings" function="testConnection">
+      		<Params/>
+        </Request>
+
+ Response: info message or error message. + + + +

Profile

+

getProfile

+ Request: + 
+	<Request class="profile" function="getProfile">
+      		<Params id="...">
+        </Request>
+
+

Attribute id is an id of user whose profile is needed to be received (optional, equals id of owner of current account by default).

+ Response: + 
+	<Response class="profile" function="getProfile">
+      		<Params id="...">
+			<string name="FirstName"> ... </string>
+            		<string name="NickName"> ... </string>
+            		<string name="LastName"> ... </string>
+            		<string name="Gender"> ... </string>
+            		<string name="Birthday"> ... </string>
+            		<string name="MobilePhone"> ... </string>
+            		<string name="HomePhone"> ... </string>
+            		<img name="Img"> ... </img>
+            		<string name="CityName"> ... </string>
+            		<string name="CountryName"> ... </string>
+        	</Params>
+	</Response>
+
+ +

getBaseProfile

+ Request: + 
+	<Request class="profile" function="getBaseProfile">
+      		<Params id="...">
+        </Request>
+
+

Attribute id is an id of user whose profile is needed to be received (optional, equals id of owner of current account by default).

+ Response: + 
+	<Response class="profile" function="getBaseProfile">
+      		<Params id="...">
+			<string name="FirstName"> ... </string>
+            		<string name="NickName"> ... </string>
+            		<string name="LastName"> ... </string>
+            	</Params>
+	</Response>
+
+ + + +

Friends

+

getListFriends

+ Request: + 
+	<Request class="friends" function="getListFriends">
+      		<Params id="...">
+			<number name="page"> ... </number>
+			<number name="pageSize"> ... </number>
+		</Params>
+        </Request>
+
+
    +
  • page - number of page that is requested (optional, positive integer, equals 1 by default)
    • +
  • pageSize - page size (optional, positive integer, equals 100 by default)
    • +
  • id - user id (optional, equals id of owner of current account by default)
    • +
+ Response: + 
+	<Response class="friends" function="getListFriends">
+      		<Params id="...">
+			<array name="contactList" page="..." pageSize="..." quantity="...">
+				<struct name="contact" id="...">
+					<string name="FirstName"> ... </string>
+            				<string name="NickName"> ... </string>
+            				<string name="LastName"> ... </string>
+					<string name="FriendStatus"> ... </string>
+                     			<img name="Img"> ... </img>
+				</struct>
+			</array>
+            	</Params>
+	</Response>
+
+ +

deleteFriend

+ Request: + 
+	<Request class="friends" function ="deleteFriend">
+      		<Params id="..."/>
+        </Request>
+
+ Response: info message or error message. + + + +

Photos

+

createAlbum

+ Request: + 
+	<Request class="photos" function="createAlbum">
+      		<Params id="...">
+			<string name="name"> ... </string>
+            		<string name="description"> ... </string>
+            		<string name="privacy">PRIVACY</string>
+		</Params>
+        </Request>
+
+ PRIVACY can have following values: +
    +
  • SELF - created album will be available only for its owner;
    • +
  • ALL_FRIENDS - created album will be available for owner's friends;
    • +
  • FRIENDS_OF_FRIENDS - created album will be available only for owner's friends and their friends;
    • +
  • EVERYONE - created album will be available only for every user.
    • +
+

This set of values can be extended. If PRIVACY isn't set, driver use default setting for all new albums which are set by user.

+
    +
  • id - optional, equals id of owner of current account by default
    • +
  • name - optional, equals "no_name" by default
    • +
  • description - optional
    • +
+ Response: + 
+	<Response class="photos" function="createAlbum">
+      		<Params id="...">
+			<string name="albumId"> ... </string>
+            	</Params>
+	</Response>
+
+ +

getListAlbums

+ Request: + 
+	<Request class="photos" function="getListAlbums">
+      		<Params id="..."/>
+        </Request>
+
+

id - optional, equals id of owner of current account by default.

+ Response: + 
+	<Response class="photos" function="getListAlbums">
+      		<Params>
+			<array name="albumList" quantity="..." ownerId="...">
+				<struct name="album" id="...">
+					<string name="title"> ... </string>
+            				<string name="description"> ... </string>
+            				<string name="thumbId"> ... </string>
+					<img name="Img"> ... </img>
+					<number name="created"> ... </number>
+                     			<number name="updated"> ... </number>
+					<number name="size"> ... </number>
+					<number name="canUpload"> ... </number>
+				</struct>
+			</array>
+            	</Params>
+	</Response>
+
+

canUpload - optional, if this parameter isn't set, it means that album is available for current user.

+ +

uploadPhoto

+ Request: + 
+	<Request class="photos" function = "uploadPhoto">
+     		<Params>
+         		<string name="albumId"> ... </string>
+         		<string name="albumName"> ... </string>
+         		<string name="albumPrivacy"> ... </string>
+         		<string name="albumDescription"> ... </string>
+         		<string name="file"> ... </string>
+         		<string name="fileName"> ... </string>
+         		<string name="description"> ... </string>
+         		<string name="tags"> ... </string>
+     		</Params>
+	</Request>
+
+
    +
  • There have to be only one of parameters albumName or albumId in request.
    • +
  • If albumId is set, photo is uploaded to this album.
    • +
  • If albumId isn't specified, new album is created (with name albumName, description albumDescription and private settings albumPrivacy).
    • +
  • If both parameters albumName and albumId aren't specified, driver returns error message or photo is uploaded to common album, which is available in some services.
    • +
  • Parameter tags can not be supported by some services.
    • +
  • Parameter file contains full path to file for sending.
    • +
  • Parameter fileName contains name of file for upload.
    • +
+ Response: + 
+	<Response class="photos" function = "uploadPhoto">
+     		<Params>
+         		<string name="albumId"> ... </string>
+        		<string name="photoId"> ... </string>
+     		</Params>
+	</Response>
+
+ +

getListPhotos

+ Request: + 
+	<Request class="photos" function = "getListPhotos">
+     		<Params id="...">
+        		<string name="albumId"> ... </string>
+        		<number name="page"> ... </number>
+        		<number name="pageSize"> ... </number>
+     		</Params>
+	</Request>
+
+
    +
  • page - number of page that is requested (optional, positive integer, equals 1 by default)
    • +
  • pageSize - page size (optional, positive integer, equals 100 by default)
    • +
  • id - user id (optional, equals id of owner of current account by default)
    • +
+ Response: + 
+	<Response class="photos" function="getListPhotos">
+    		<Params>
+        		<array name="photosList" page="..." pageSize="..." quantity="..." ownerId="..." albumId="...">
+            			<struct name="photo" id="..."/>
+                			<string name="urlSmall"> ... </string>
+               				<string name="urlBig"> ... </string>
+                			<string name="urlOrig"> ... </string>
+                			<string name="description"> ... </string>
+                			<number name="created"> ... </number>
+            			</struct>
+        		</array>
+    		</Params>
+	</Response>
+
+ +

getListUserPhotos

+ Request: + 
+	<Request class="photos" function = "getListUserPhotos">
+     		<Params id="...">
+        		<number name="page"> ... </number>
+        		<number name="pageSize"> ... </number>
+     		</Params>
+	</Request>
+
+
    +
  • page - number of page that is requested (optional, positive integer, equals 1 by default)
    • +
  • pageSize - page size (optional, positive integer, equals 100 by default)
    • +
  • id - user id (optional, equals id of owner of current account by default)
    • +
+ Response: + 
+	<Response class="photos" function="getListUserPhotos">
+   		<Params>
+        		<array name="photosList" page="..." pageSize="..." quantity="...">
+            			<struct name="photo" id="..."/>
+                			<string name="ownerId"> ... </string>
+                			<string name="albumId"> ... </string>
+                			<string name="urlSmall"> ... </string>
+                			<string name="urlBig"> ... </string>
+                			<string name="urlOrig"> ... </string>
+                			<string name="description"> ... </string>
+                			<number name="created"> ... </number>
+            			</struct>
+        		</array>
+    		</Params>
+	</Response>
+
+ +

getListPhotoTags

+ Request: + 
+	<Request class="photos" function = "getListPhotoTags">
+     		<Params>
+                	<string name="ownerId"> ... </string>
+                	<string name="albumId"> ... </string>
+                	<string name="photoId"> ... </string>
+     		</Params>
+	</Request>
+
+ Response: + 
+	<Response class="photos" function="getListPhotoTags">
+    		<Params>
+        		<array name="tagsList" quantity="..." ownerId="..." albumId="..." photoId="...">
+            			<struct name="tag" id="..."/>
+                			<string name="userId"> ... </string>
+                			<string name="text"> ... </string>
+                			<number name="created"> ... </number>
+            			</struct>
+        		</array>
+    		</Params>
+	</Response>
+
+

Parameter userId is an id of user which is marked on photo (optional).

+ +

getListFavoritePhotos

+ Request: + 
+	<Request class="photos" function = "getListFavoritePhotos">
+     		<Params id="...">
+        		<number name="page"> ... </number>
+        		<number name="pageSize"> ... </number>
+     		</Params>
+	</Request>
+
+
    +
  • page - number of page that is requested (optional, positive integer, equals 1 by default)
    • +
  • pageSize - page size (optional, positive integer, equals 100 by default)
    • +
  • id - user id (optional, equals id of owner of current account by default)
    • +
+ Response: + 
+	<Response class="photos" function="getListFavoritePhotos">
+    		<Params>
+        		<array name="photosList" page="..." pageSize="..." quantity="...">
+            			<struct name="photo" id="..."/>
+                			<string name="ownerId"> ... </string>
+                			<string name="albumId"> ... </string>
+                			<string name="urlSmall"> ... </string>
+                			<string name="urlBig"> ... </string>
+                			<string name="urlOrig"> ... </string>
+                			<string name="description"> ... </string>
+                			<number name="created"> ... </number>
+            			</struct>
+        		</array>
+    		</Params>
+	</Response>
+
+ +

getPhoto

+ Request: + 
+	<Request class="photos" function = "getPhoto">
+     		<Params>
+        		<string name="url"> ... </string>
+        		<string name="path"> ... </string>
+     		</Params>
+	</Request>
+
+ Response: info message or error message. + +

getListPhotoComments

+ Request: + 
+	<Request class="photos" function = "getListPhotoComments">
+     		<Params>
+        		<string name="ownerId"> ... </string>
+       			<string name="albumId"> ... </string>
+        		<string name="photoId"> ... </string>
+        		<number name="page"> ... </number>
+        		<number name="pageSize"> ... </number>
+     		</Params>
+	</Request>
+
+
    +
  • page - number of page that is requested (optional, positive integer, equals 1 by default)
    • +
  • pageSize - page size (optional, positive integer, equals 100 by default)
    • +
+ Response: + 
+	<Response class="photos" function="getListPhotoComments">
+    		<Params>
+        		<array name="commentsList" page="..." pageSize="..."  quantity="..." ownerId="..." albumId="..." photoId="...">
+            			<struct name="comment" id="..."/>
+                			<string name="ParentId"> ... </string>
+                			<string name="SenderId"> ... </string>
+                			<string name="SenderName"> ... </string>
+                			<string name="Time"> ... </string>
+                			<string name="Text"> ... </string>
+            			</struct>
+        		</array>
+    		</Params>
+	</Response>
+
+

Parameter ParentId is an id of previous comment, if there is such one (optional).

+ +

sendPhotoComment

+ Request: + 
+	<Request class="photos" function="sendPhotoComment">
+     		<Params>
+        		<string name="ownerId"> ... </string>
+        		<string name="albumId"> ... </string>
+        		<string name="photoId"> ... </string>
+        		<string name="text"> ... </string>
+     		</Params>
+	</Request>
+
+ Response: info message or error message. + + + +

Messages

+

getListOutboxMessages

+ Request: + 
+	<Request class="messages" function="getListOutboxMessages">
+     		<Params>
+        		<number name="page"> ... </number>
+        		<number name="pageSize"> ... </number>
+          		<number name="timeOffset"> ... </number>
+     		</Params>
+	</Request>
+
+
    +
  • page - number of page that is requested (optional, positive integer, equals 1 by default)
    • +
  • pageSize - page size (optional, positive integer, equals 100 by default)
    • +
  • timeOffset - time offset for requested messages
    • +
+ Response: + 
+	<Response class="messages" function = "getListOutboxMessages">              
+      		<Params>
+            		<array name="messageList" page="..." pageSize="..." quantity="...">
+                 		<struct name="message" id="...">             
+                       			<string name="SenderId"> ... </string>
+                       			<string name="SenderName"> ... </string>
+                       			<array name="recipientList" quantity="...">
+                             			<struct name="recipient">
+                                  			<string name="RecipientId"> ... </string>
+                                   			<string name="RecipientName"> ... </string>
+                             			</struct>
+                       			</array>
+                       			<string name="Time"> ... </string>
+                       			<string name="Title"> ... </string>
+                       			<string name="Text"> ... </string>
+                       			<string name="Status"> ... </string>
+                       			<attachment id="..." ownerId="..." type="...">
+                       			 ...
+                       			</attachment>
+                 		</struct>
+             		</array>
+       		</Params>
+	</Response>
+
+

Parameter attachment is optional, its content depends on attribute type and can have following values:

+ 
+	<attachment id="..." ownerId="..." type="image">
+        	<string name="name"> ... </string>      
+        	<string name="albumId"> ... </string>
+                <string name="urlSmall"> ... </string>
+                <string name="urlBig"> ... </string>
+        </attachment>
+
+	<attachment id="..." ownerId="..." type="video">
+        	<string name="name"> ... </string>
+        	<string name="url"> ... </string>
+                <number name="duration"> ... </number>
+                <string name="urlImage"> ... </string>
+        </attachment>
+
+	<attachment id="..." ownerId="..." type="audio">
+		<string name="name"> ... </string>
+		<string name="url"> ... </string>
+		<number name="duration"> ... </number>
+        </attachment>
+
+	<attachment id="..." ownerId="..." type="link">
+       		<string name="name"> ... </string>
+                <string name="url"> ... </string>
+                <string name="urlImage"> ... </string>
+        </attachment>
+
+	<attachment id="..." ownerId="..." type="note">
+		<string name="name"> ... </string>
+		<string name="url"> ... </string>
+	</attachment>
+
+ + + + + +

Audio

+

getListAudio

+ Request: + 
+	<Request class="audio" function="getListAudio">
+      		<Params id="...">
+		</Params>
+        </Request>
+
+ Response: + 
+	<Response class="audio" function="getListAudio">
+      		<Params id="...">
+			<array name="audioList" quantity="..." ownerId="...">
+				<struct name="audio" id="...">
+					<string name="title"> ... </string>
+            				<string name="artist"> ... </string>
+            				<number name="duration"> ... </number>
+					<string name="audio"> ...url... </string>
+				</struct>
+			</array>
+            	</Params>
+	</Response>
+
+ + + +

Video

+

getListVideo

+ Request: + 
+	<Request class="video" function="getListVideo">
+      		<Params id="...">
+		</Params>
+        </Request>
+
+ Response: + 
+	<Response class="video" function="getListVideo">
+      		<Params>
+			<array name="videoList" quantity="..." ownerId="...">
+				<struct name="video" id="...">
+					<string name="title"> ... </string>
+            				<string name="description"> ... </string>
+            				<number name="duration"> ... </number>
+					<img name="Img"> ...url... </img>
+					<string name="link"> ...url... </string>
+					<string name="url"> ...url to player... </string>
+				</struct>
+			</array>
+            	</Params>
+	</Response>
+
+ + + +

News

+ +

Info and error messages

+

Error message format

+ 
+	<Response class="systemMessages" function = "errorMessage">              
+    		<Params>
+        		<string name="moduleName"> ... </string>
+        		<string name="code"> ... </string>
+        		<string name="text"> ... </string>
+        		<string name="comment"> ... </string>
+        		<string name="type">user/internal/service </string>
+    		</Params>
+	</Response>
+
+ +

Info message format

+ 
+	<Response class="systemMessages" function = "infoMessage">              
+    		<Params>
+        		<string name="moduleName"> ... </string>
+    		</Params>
+	</Response>
+
+ + +
+ + + +
MySocials Project © 2011
 
+ + diff --git a/www/development.html b/www/development.html new file mode 100644 index 0000000..f5d9a5f --- /dev/null +++ b/www/development.html @@ -0,0 +1,98 @@ + + + + +MySocials Project + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + +
MySocials API|Privacy|Development|Downloads
+ + + + + + + + + + + + +
+ + + +
+

Development

+

MySocials Gallery is free open source software. MySocials Gallery distributed under the terms of the GNU GPL license.

+

Project wiki (in russian)

+

Bugzilla

+

Project repository

+

e-mail list: maemo-mysocials@cs.karelia.ru

+ +

The project is done by FRUCT Lab at the IT-park of Petrozavodsk State University (PetrSU), Russia.

+

Project owner: Sergey I. Balandin, PhD, Adjunct Professor, FRUCT General Chair, Helsinki, Finland.

+

Technical coach: Timofei V. Turenko, PhD, FRUCT Maemo/MeeGO WG Head.

+

Head of PetrSU FRUCT Lab: Iurii A. Bogoiavlenskii, PhD, Head of Department of Computer Science, PetrSU.

+

Manager: Kirill A. Kulakov, PhD kulakov@cs.karelia.ru

+

Expert: Alexandr V. Borodin aborod@cs.karelia.ru

+

Developers:

+

+
+ + + +
MySocials Project © 2011
 
+ + diff --git a/www/development_ru.html b/www/development_ru.html new file mode 100644 index 0000000..e29f626 --- /dev/null +++ b/www/development_ru.html @@ -0,0 +1,98 @@ + + + + +MySocials Gallery + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + + + +
Описание & Ð˜ÑÐ¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ð½Ð¸Ðµ|Kонфиденциальность | Разработка | Загрузки | English
+ + + + + + + + + + + + +
+ + + +
+

Разработка

+

MySocials Gallery является свободным программным обеспечением и распространяется согласно условиям лицензии GNU GPL.

+

Вики проекта

+

Bugzilla

+

Репозиторий проекта

+

Список рассылки: maemo-mysocials@cs.karelia.ru

+ +

Проект выполнен в лаборатории FRUCT IT-парка Петрозаводского государственного университета (ПетрГУ).

+

Куратор проекта: C. И. Баландин, к.т.н., доцент, Председатель Программы FRUCT, Хельсинки, Финляндия.

+

Технический консультант: Т. В. Туренко, к.т.н., Глава рабочей группы FRUCT Maemo/MeeGo, Хельсинки, Финляндия.

+

Зав. лабораторией FRUCT ПетрГУ: Ю. А. Богоявленский, к.т.н., доцент, зав. кафедрой Информатики и математического обеспечения ПетрГУ.

+

Менеджер: к.ф.-м.н., К. Ð. ÐšÑƒÐ»Ð°ÐºÐ¾Ð² kulakov@cs.karelia.ru

+

Эксперт: А. Ð’. Ð‘ородин aborod@cs.karelia.ru

+

Разработчики:

+

+
+ + + +
MySocials Gallery © 2011
 
+ + diff --git a/www/downloads.html b/www/downloads.html new file mode 100644 index 0000000..65fcad6 --- /dev/null +++ b/www/downloads.html @@ -0,0 +1,87 @@ + + + + +MySocials Project + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + +
MySocials API|Privacy|Development|Downloads
+ + + + + + + + + + + + +
+ + + +
+

Downloads

+

Source code of the project is available on Gitorious.

+

Here you can get the packages of MySocials Gallery for different platforms:

+ +

Fedora: Fedora 14

+

Mandriva: Mandriva 2010.1

+

openSUSE: openSUSE 11.3

+

MeeGo: MeeGo 1.1

+

Ubuntu: Ubuntu 10.10

+

Maemo: Maemo 5

+

You can use this button to install MySocials Gallery on your Maemo 5 device:

+
+ + + +
MySocials Project © 2011
 
+ + diff --git a/www/downloads_ru.html b/www/downloads_ru.html new file mode 100644 index 0000000..0f7d574 --- /dev/null +++ b/www/downloads_ru.html @@ -0,0 +1,88 @@ + + + + +MySocials Gallery + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + + + +
Описание & Ð˜ÑÐ¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ð½Ð¸Ðµ|Kонфиденциальность | Разработка | Загрузки | English
+ + + + + + + + + + + + +
+ + + +
+

Загрузки

+

Исходный код проекта доступен на Gitorious.

+

Ссылки для скачивания пакетов MySocials Gallery для различных платформ:

+

Fedora: Fedora 14

+

Mandriva: Mandriva 2010.1

+

openSUSE: openSUSE 11.3

+

MeeGo: MeeGo 1.1

+

Ubuntu: Ubuntu 10.10

+

Maemo: Maemo 5

+

Для установки приложения MySocials Gallery на мобильное устройство с платформой Maemo 5 воспользуйтесь данной кнопкой:

+
+ + + +
MySocials Gallery © 2011
 
+ + diff --git a/www/images/account-settings.png b/www/images/account-settings.png new file mode 100644 index 0000000..0702de5 Binary files /dev/null and b/www/images/account-settings.png differ diff --git a/www/images/add-account.png b/www/images/add-account.png new file mode 100644 index 0000000..eeedf15 Binary files /dev/null and b/www/images/add-account.png differ diff --git a/www/images/application_install.png b/www/images/application_install.png new file mode 100644 index 0000000..5984c94 Binary files /dev/null and b/www/images/application_install.png differ diff --git a/www/images/auth.png b/www/images/auth.png new file mode 100644 index 0000000..92b6185 Binary files /dev/null and b/www/images/auth.png differ diff --git a/www/images/comments.png b/www/images/comments.png new file mode 100644 index 0000000..6803b4e Binary files /dev/null and b/www/images/comments.png differ diff --git a/www/images/download-image-for-show.png b/www/images/download-image-for-show.png new file mode 100644 index 0000000..a85af18 Binary files /dev/null and b/www/images/download-image-for-show.png differ diff --git a/www/images/friend-albums.png b/www/images/friend-albums.png new file mode 100644 index 0000000..c78ede3 Binary files /dev/null and b/www/images/friend-albums.png differ diff --git a/www/images/friend-photos.png b/www/images/friend-photos.png new file mode 100644 index 0000000..a165c66 Binary files /dev/null and b/www/images/friend-photos.png differ diff --git a/www/images/friend-search.png b/www/images/friend-search.png new file mode 100644 index 0000000..6a9022d Binary files /dev/null and b/www/images/friend-search.png differ diff --git a/www/images/general_back.png b/www/images/general_back.png new file mode 100644 index 0000000..f94ebc6 Binary files /dev/null and b/www/images/general_back.png differ diff --git a/www/images/general_backspace.png b/www/images/general_backspace.png new file mode 100644 index 0000000..64ec10f Binary files /dev/null and b/www/images/general_backspace.png differ diff --git a/www/images/general_refresh.png b/www/images/general_refresh.png new file mode 100644 index 0000000..18c8460 Binary files /dev/null and b/www/images/general_refresh.png differ diff --git a/www/images/icon.png b/www/images/icon.png new file mode 100644 index 0000000..d8fe912 Binary files /dev/null and b/www/images/icon.png differ diff --git a/www/images/image-show.png b/www/images/image-show.png new file mode 100644 index 0000000..630536c Binary files /dev/null and b/www/images/image-show.png differ diff --git a/www/images/main-window.png b/www/images/main-window.png new file mode 100644 index 0000000..a4b6271 Binary files /dev/null and b/www/images/main-window.png differ diff --git a/www/images/menu.png b/www/images/menu.png new file mode 100644 index 0000000..aa3ccba Binary files /dev/null and b/www/images/menu.png differ diff --git a/www/images/network-settings.png b/www/images/network-settings.png new file mode 100644 index 0000000..ebbdbee Binary files /dev/null and b/www/images/network-settings.png differ diff --git a/www/images/program-settings.png b/www/images/program-settings.png new file mode 100644 index 0000000..c3b8099 Binary files /dev/null and b/www/images/program-settings.png differ diff --git a/www/images/send-comment.png b/www/images/send-comment.png new file mode 100644 index 0000000..4148276 Binary files /dev/null and b/www/images/send-comment.png differ diff --git a/www/index.html b/www/index.html new file mode 100644 index 0000000..f4c3a63 --- /dev/null +++ b/www/index.html @@ -0,0 +1,81 @@ + + + + +MySocials Project + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + + + +
Description & Usage|Privacy|Development|Downloads | MySocials API
+ + + + + + + + + + + + +
+ + + +
+

Description & Usage

+

Work with application

+ +
+ + + +
MySocials Project © 2011
 
+ + diff --git a/www/index_ru.html b/www/index_ru.html new file mode 100644 index 0000000..5e4bd21 --- /dev/null +++ b/www/index_ru.html @@ -0,0 +1,145 @@ + + + + +MySocials Gallery + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + + + +
Описание & Ð˜ÑÐ¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ð½Ð¸Ðµ|Kонфиденциальность | Разработка | Загрузки | English
+ + + + + + + + + + + + +
+ + + +
+

Описание & Ð˜ÑÐ¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ð½Ð¸Ðµ

+

Работа с приложением

+

Приложение MySocials Gallery предназначено для просмотра галерей и изображений, созданных на различных социальных сервисах. Оно позволяет пользователю просматривать собственные изображения и галереи, а также галереи, созданные его друзьями. Текущая версия приложения поддерживает такие социальные сервисы, как Facebook, VKontakte и Flickr.

+

На данном сайте представлено описание работы MySocials Gallery на мобильном устройстве на платформе Maemo 5 (Nokia N900). Приложение работает аналогично и на других платформах.

+

При первом запуске MySocials Gallery отображается окно "Добавление новой учетной записи". Вам необходимо ввести название новой учетной записи и выбрать из списка один из поддерживаемых сервисов.

+

+

+ После этого Вам необходимо пройти авторизацию на сервисе. Приложение использует авторизацию через веб-интерфейс (с помощью приложения Webauth). Приложение не хранит вашу регистрационную информацию (логины и пароли доступа к сервисам). Поэтому если текущая пользовательская сессия истекла, то приложение отобразит окно для повторной авторизации.

+

+

+ В приложении MySocials Gallery существуют два вида форм для отображения информации: главная форма и форма просмотра изображений. Главная форма состоит из двух панелей и нескольких кнопок. Кнопка позволяет обновить данные в приложении. Кнопка позволяет вернуться к предыдущей панели. Например, если Вы просматриваете список альбомов и изображений пользователя, то данная кнопка вернет Вас к просмотру списка друзей и альбомов. +

+

+ После того, как Вы создадите учетную запись и пройдете авторизацию на сервисе, Вы увидите главную форму приложения, на которой будут расположены список друзей и список Ваших альбомов. +

+

+

+ Чтобы найти друга в списке, Вы можете воспользоваться специальным полем для быстрого поиска. Кнопка позволяет очистить данное поле. +

+

+

+ Для того, чтобы просмотреть список альбомов друга, найдите его в списке и щелкните по нему. +

+

+

+ После этого Вы перейдете к списку альбомов выбранного пользователя и списку изображений в каждом альбоме. +

+

+

+ Для просмотра изображения в полноэкранном режиме щелкните по нему. Если приложение еще не загрузило изображение с сервиса, то отображется его уменьшенная копия. +

+

+

После загрузки Вы увидите изображение в полноэкранном режиме. На данной форме приложения находится меню, с помощью которого можно работать с комментариями к изображению (ели данная услуга поддерживается сервисом). Оно содержит такие пункты меню как "Обновить комментарии" и "Добавить комментарий".

+

+

Под изображением расположен список комментариев к нему.

+

+

Для того, чтобы отправить свой комментарий к текущему изображению, воспользуйтесь пунктом меню "Добавить комментарий".

+

+ +

Настройки приложения

+

+ Для настройки MySocials Gallery необходимо воспользоваться главным меню. Данное меню доступно на главной форме приложения. +

+

+

+ Пункт меню "Настройка сети" позволяет Вам настроить параметры прокси сервера. + Кнопка "Без прокси" отключает поиск настроек прокси на вашем устройстве. + Кнопка "Системный" включает поиск настроек прокси на вашем устройстве для их использования приложением. + Кнопка "Вручную" активирует поля для ввода адреса и порта для работы с прокси сервером. +

+

+

+ Вы можете редактировать список созданных в приложении учетных записей с помощью пункта + меню "Настройка учетных записей". + Кнопка "Добавить" позволяет создать новую учетную запись. Кнопка "Удалить" позволяет удалить одну из существующих учетных записей. Кнопка "Переподключиться" позволяет пройти повторную авторизацию на сервисе. Этой кнопкой следует воспользоваться, если возникли проблемы с подключением устройства к сети и учетная запись была переведена в автономный режим. В этом случае Вам необходимо выбрать из списка проблемную учетную запись и нажать данную кнопку. Также необходимо воспользоваться данной кнопкой, если Вы хотите авторизоваться на сервисе, использую другой логин и пароль. +

+

+

+ Пункт меню "Настройка приложения" позволяет установить некоторые специальные настройки приложения. + Пункт "Включить поворот окна" доступен только для мобильных устройств. + Он позволяет приложению реагировать на изменения положения устройства в пространстве и + активировать горизонтальный или вертикальный режим работы. + Пункт "Включить многопанельный режим" контролирует количество панелей на главной форме приложения. + Если этот пункт меню активен, то главная форма приложения состоит из двух панелей. Справа отображается + текущая панель (например, список изображений в альбоме), слева - предыдущая панель (список альбомов пользователя). Если же данный пункт не активен, то на главной форме отображается только текущая панель. Данная настройка полезна для устойств с малым экраном, таких как мобильные устройства. Кнопка "Очистить кэш" позволяет очистить кэш приложения для освобождения ресурсов устройства. +

+

+
+ + + +
MySocials Gallery © 2011
 
+ + diff --git a/www/privacy.html b/www/privacy.html new file mode 100644 index 0000000..c20bdb1 --- /dev/null +++ b/www/privacy.html @@ -0,0 +1,83 @@ + + + + +MySocials Project + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + +
MySocials API|Privacy|Development|Downloads
+ + + + + + + + + + + + +
+ + + +
+

Privacy

+

One of the most imporant features of MySocials is the use of autorization through web-interface (Webauth).

+

+

+ The application doesn't store your registration information (e.g. login and password). + Therefore if your session is out of date, the application shows autorization window again. +

+
+ + + +
MySocials Project © 2011
 
+ + diff --git a/www/privacy_ru.html b/www/privacy_ru.html new file mode 100644 index 0000000..b0a4b20 --- /dev/null +++ b/www/privacy_ru.html @@ -0,0 +1,84 @@ + + + + +MySocials Gallery + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
 
 
+ + + + + + + + + + + +
Описание & Ð˜ÑÐ¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ð½Ð¸Ðµ|Kонфиденциальность | Разработка | Загрузки | English
+ + + + + + + + + + + + +
+ + + +
+

Конфиденциальность

+

Основной особенностью приложения MySocials Gallery является использование специального приложения для прохождения авторизации на сервисах через веб-интерфейс (Webauth).

+

+

+ Приложение не хранит вашу регистрационную информацию (логины и пароли доступа к сервисам). + Поэтому если текущая пользовательская сессия истекла, то приложение отобразит окно для повторной авторизации.

+
+ + + +
MySocials Gallery © 2011
 
+ + diff --git a/www/style.css b/www/style.css new file mode 100644 index 0000000..36e60ea --- /dev/null +++ b/www/style.css @@ -0,0 +1,87 @@ +body +{ margin-top:0px; + margin-left:0px; + margin-right:0px; + margin-bottom:0px; + font: normal small Arial, Helvetica, sans-serif; + color:#6C6C6C; + background-color:#CFCFB0; + } + .logo{ + + font-size:25px; + color:#323844; + font-weight:bold; + padding-left:15px; + text-decoration:none; +} +.tag { + margin: 0; + text-transform: uppercase; + font-size:13px; + padding-left:15px; + font-weight:bold; + color:#656558; + letter-spacing:2px; + text-decoration:none; +} +.toplinks{ +text-transform: uppercase; +font-size:13px; +color:#323844; +font-weight:bold; +text-decoration:none; +} +.toplinks:hover{ +text-transform: uppercase; +font-size:13px; +color:#8E8E79; +font-weight:bold; +text-decoration:none; +} +.content +{ +text-align:justify; +line-height:120%; +padding-left:10px; padding-right:10px; padding-bottom:10px; padding-top:10px; +} +.links{ +color:#323844; +text-decoration:underline; +} +.links:hover{ +color:#323844; +text-decoration:none; +} +.heading { +text-transform: uppercase; +padding-left:10px; + font-size:14px; + font-weight:bold; + color: #FF5800; +} +.heading2{ +text-transform: uppercase; +padding-left:5px; + font-size:14px; + font-weight:bold; + color: #81816D; +} +.border +{border:1px solid #8E8E79; +} +.redbox +{background-color:#FF5800; +border-bottom:1px solid #F1F1D8; +border-right:1px solid #F1F1D8; +border-left:1px solid #F1F1D8; +} +.copybox +{background-color:#E2E2D2; +border-bottom:1px solid #8E8E79; +border-right:1px solid #8E8E79; +border-left:1px solid #8E8E79; +height:40px; +padding-left:300px; +color:#7B7B68; +}