تصميم:دواسوا/workflow - تاريخ المراجعة

أحمد: requesting user listings and removing listings

2017-01-28T23:18:20Z

requesting user listings and removing listings

أحمد: نحو التنسيق

2017-01-02T00:45:31Z

نحو التنسيق

أحمد: وظائف النظام

2017-01-01T19:49:27Z

وظائف النظام

أحمد: تنميط أسماء المتغيرات بشرطات في المنتصف بدل على السطر

2016-12-31T15:17:49Z

تنميط أسماء المتغيرات بشرطات في المنتصف بدل على السطر

أحمد: مبدئيا

2016-12-31T15:13:51Z

مبدئيا

صفحة جديدة

<div dir="ltr" style="direction: ltr;">
== Insertion request ==
The final insertion into the index is concluded after the user follows a URL [[../رسائل البريد|sent to the email address]] specified in the request. The URL includes a [[../cryptographic token|cryptographic token]] that uniquely identifies this request. If the insertion is not concluded within the duration specified via the [[../configuration variables#insertion_confirmation_grace|<var>insertion_confirmation_grace</var>]] the listing is removed from the database into the [[../archive|archive]] with a status flag of <kbd>unconfirmed</kbd>

Initiated by a [[../واجهة برمجة التطبيقات#request_insertion|<code>request_insertion</code>]] API call.

== Listing instatement ==
After a listing is instated, an [[/رسائل البريد|message is sent to]] the email address associated with the listing containing a URL which when followed will initiate the deletion process of a listing.

== Removal request ==

</div>

@@ سطر 15: / سطر 15: @@
 The final insertion into the service's listing is concluded after the user follows a URL [[../رسائل البريد#listing confirmation|sent to the email address]] specified in the request. [[#Insertion request|Before that]] it is kept in the pending queue following its [[#Insertion request|submission to the system]].
+== Removal of listings==
 Removal from the service's listings can happen either because of the [[#removal due to expiry|expiry of the package]], or due to a [[#removal due to user request|request by the user]], either because it's been given away, or another reason.
@@ سطر 25: / سطر 23: @@
 === removal due to user request ===
-A user can request the removal of an entry from the listings by requesting so via following a URL containing a [[../cryptographic token|cryptographic token]] uniquely identifying the item. This token is sent to the user for each of the items he manages upon [[#listing instatement|instatement of the listing]], in the instatement notification message sent by email. It can also be retrieved via a [[#inquiring user listings|inquiring a user's listings]]
+A user can request the removal of an entry from the listings by requesting so via following a URL containing a [[../cryptographic token|cryptographic token]] uniquely identifying the item. This token is displayed to the user for each of the items he manages upon [[#inquiring user listings|inquiring the entries associated with a given email]] address.
 Upon confirmation by the user for the removal request, the listing information is removed to the [[../data#archive|archive]] with a <var>[[../data#archive|removal-reason]]</var> of <kbd>removed-by-user</kbd>
@@ سطر 33: / سطر 31: @@
 == Inquiring user listings ==
-A user can instruct the system to send to an email address a message containing an enumeration of the listings associated with that email address. The message contaiins basic information about listings from the service, and with each entry, the URL to retrieve its full details as well as the URL to [[#removal due to user request|request its removal]].
+A user can instruct the system to send to an email address a message containing a link to the listings associated with that email address. The link is comprised of the email address and a cryptographix token. Following the link leads to a listing on the web similar to that of the search results where it is possible to [[#removal due to user request|request the removal]] of individual listings.
-This action is initiated by a <code>[[../واجهة برمجة التطبيقات#get_user_listings|get_user_listings]]</code> API call.
+This action is initiated by a <code>[[../واجهة برمجة التطبيقات#request_user_listings|get_user_listings]]</code> API call.
 </div>

@@ سطر 7: / سطر 7: @@
 The verification is completed via and a [[../رسائل البريد#listing confirmation request|message sent to the email address]] entered with the submission containing a URL that must be followed by the user. The URL sent in the email message includes a [[../cryptographic token|cryptographic token]] that uniquely identifies this request.
-If the insertion is not concluded within the duration specified via the [[../configuration variables#insertion-confirmation-grace|<var>insertion-confirmation-grace</var>]] configuration variable, the listing is removed from the database into the [[../data#archive|archive]] with a [[../data#archive|<var>removal-reason</var>]] of <kbd>unconfirmed</kbd>
+If the insertion is not concluded within the duration specified via the <var>[[../configuration variables#insertion-confirmation-grace|insertion-confirmation-grace]]</var> configuration variable, the listing is removed from the database into the [[../data#archive|archive]] with a <var>[[../data#archive|removal-reason]]</var> of <kbd>unconfirmed</kbd>
-Initiated by a [[../واجهة برمجة التطبيقات#request_insertion|<code>request_insertion</code>]] API call.
+Initiated by a <code>[[../واجهة برمجة التطبيقات#request_insertion|request_insertion]]</code> API call.
@@ سطر 22: / سطر 22: @@
 === removal due to expiry ===
-Batch removal of expired packages is achieved to the periodical execution of a task which compares package expiry dates to a value derived from the current date minus a the value set by <var>[[../configuration variables#expiry-removal-threshold|expiry-removal-threshold]]</var> where entries having an expiry date greater than or equal to the threshold are removed to the [[../data#archive|archive]] with [[../data#archive|<var>removal-reason</var>]] of <kbd>expired</kbd>.
+Batch removal of expired packages is achieved to the periodical execution of a task which compares package expiry dates to a value derived from the current date minus a the value set by <var>[[../configuration variables#expiry-removal-threshold|expiry-removal-threshold]]</var> where entries having an expiry date greater than or equal to the threshold are removed to the [[../data#archive|archive]] with <var>[[../data#archive|removal-reason]]</var> of <kbd>expired</kbd>.
 === removal due to user request ===
 A user can request the removal of an entry from the listings by requesting so via following a URL containing a [[../cryptographic token|cryptographic token]] uniquely identifying the item. This token is sent to the user for each of the items he manages upon [[#listing instatement|instatement of the listing]], in the instatement notification message sent by email. It can also be retrieved via a [[#inquiring user listings|inquiring a user's listings]]
-Upon confirmation by the user for the removal request, the listing information is removed to the [[../data#archive|archive]] with a [[../data#archive|<var>removal-reason</var>]] of <kbd>removed-by-user</kbd>
+Upon confirmation by the user for the removal request, the listing information is removed to the [[../data#archive|archive]] with a <var>[[../data#archive|removal-reason]]</var> of <kbd>removed-by-user</kbd>
-This type of removal is initiated by a [[../واجهة برمجة التطبيقات#remove_listing|<code>remove_listing</code>]] API call.
+This type of removal is initiated by a <code>[[../واجهة برمجة التطبيقات#remove_listing|remove_listing]]</code> API call.
@@ سطر 35: / سطر 35: @@
 A user can instruct the system to send to an email address a message containing an enumeration of the listings associated with that email address. The message contaiins basic information about listings from the service, and with each entry, the URL to retrieve its full details as well as the URL to [[#removal due to user request|request its removal]].
-This action is initiated by a [[../واجهة برمجة التطبيقات#get_user_listings|<code>get_user_listings</code>]] API call.
+This action is initiated by a <code>[[../واجهة برمجة التطبيقات#get_user_listings|get_user_listings]]</code> API call.
 </div>

@@ سطر 1: / سطر 1: @@
 <div dir="ltr" style="direction: ltr;">
 == Insertion request ==
-The final insertion into the index is concluded after the user follows a URL [[../رسائل البريد|sent to the email address]] specified in the request. The URL includes a [[../cryptographic token|cryptographic token]] that uniquely identifies this request. If the insertion is not concluded within the duration specified via the [[../configuration variables#insertion-confirmation-grace|<var>insertion-confirmation-grace</var>]] the listing is removed from the database into the [[../archive|archive]] with a status flag of <kbd>unconfirmed</kbd>
+When  user [[#Listing instatement|submits an item to be listed]], it is kept in pending queue until the submission is verified by the user. For the submission request to be accepted the remaining time until the expiry date entered has to be greater than or equal to the value set by the configuration variable <var>[[../configuration variables#expiry-acceptance-threshold|expiry-acceptance-threshold]]</var>.
 Initiated by a [[../واجهة برمجة التطبيقات#request_insertion|<code>request_insertion</code>]] API call.
@@ سطر 7: / سطر 13: @@
 == Listing instatement ==
-After a listing is instated, an [[/رسائل البريد|message is sent to]] the email address associated with the listing containing a URL which when followed will initiate the deletion process of a listing.
+The final insertion into the service's listing is concluded after the user follows a URL [[../رسائل البريد#listing confirmation|sent to the email address]] specified in the request. [[#Insertion request|Before that]] it is kept in the pending queue following its [[#Insertion request|submission to the system]].
 == Removal request ==
 </div>