<!--
source: https://draugiem.eu/applications/dev/docs/say/
format: markdown (generated for LLM / machine consumption)
language: lv
index: https://draugiem.eu/applications/dev/docs/llms.txt
-->

# "Ieteikt draugiem" funkcija

## Ieteikto ziņu saraksts

Esam izveidojuši rīku, kas ļauj jūsu lapā attēlot informāciju par populārākajiem portālā draugiem.lv ieteiktajiem lapas rakstiem un to ieteicējiem (ieteicēji tiek attēloti, ja lietotājs ir ienācis draugiem.lv).

Lai ievietotu sarakstu savā lapā, izmantojiet šo kodu:

```xml
<iframe src="https://www.draugiem.lv/say/ext/recommend.php?url=...&count=..." frameborder="0"></iframe>
```

Kodā atbilstoši atvērtajai lapai jānomaina šie parametri (jāatceras, ka parametri saitē jāievieto *urlencoded* formātā):

- **`url`**: Lapas adrese (nenorādot šo parametru, tiks paņemta lapas adrese no HTTP referrer)
- **`count`**: Rakstu skaits, kas tiks attēlos rīkā. (2-15)
- **`scrollable`**: Ja norādīts šis parametrs ar vērtību "1" un rakstu kopējais augstums pārsniegs rīka augstumu, tad saturs būs ar ritjoslu.
- **`height`**: Neobligāts paramets, kur nosaka iekšējā rāmja augstumu (noklusēti satura augstums)

Lai rīks spētu attēlot rakstu attēlus, raksta HTML kodā ir nepieciešams *meta* tags ar saiti uz raksta attēlu. Ieteicamais izmērs 50x50, bet der arī citi izmēri, bet tad attēls būs nedaudz saspiests vai izstiepts. Ja rakstam nav attēla, ieteicams padot lapas logo.

Pievienojamie *meta* tagi:

```xml
<meta name="dr:say:img" content="https://ifrype.com/img/clogo/applications.png" />
<meta name="dr:say:title" content="Raksta virsraksts" />
```

Ievietotais saraksts izskatīsies šādi:

![img/say_box.png](https://draugiem.eu/applications/img/say_box.png)

## Vienkārša ieteikšanas funkcija

Lai pievienotu iespēju lietotājiem ieteikt savas lapas saturu atliek vien pievienot pavisam vienkāršu JavaScript funkciju savas lapas kodam un izsaukt to ar atbilstošiem parametriem:

```
function DraugiemSay( title, url, titlePrefix ){
 window.open(
  'https://www.draugiem.lv/say/ext/add.php?title=' + encodeURIComponent( title ) +
  '&link=' + encodeURIComponent( url ) +
  ( titlePrefix ? '&titlePrefix=' + encodeURIComponent( titlePrefix ) : '' ),
  '',
  'location=1,status=1,scrollbars=0,resizable=0,width=530,height=400'
 );
 return false;
}
```

Atbilstošais funkcijas izsaukuma kods:

```
DraugiemSay('Ieraksta virsraksts, zem kura slēpsies saite', 'https://links.uz.resursu.lv/ar/pilnu/celju/uz/failu.html', 'Mana Lapa');
```

Ieteikšanas pogai vēlams izmantot draugiem.lv piedāvāto ikonu:

![/i/say/add.png](https://draugiem.eu/i/say/add.png)

Rezultāts izskatīsies aptuveni šādi:

![img/picture-12.png](https://draugiem.eu/applications/img/picture-12.png)

## Draugiem.lv "Runā" grāmatzīme

Ja kādā no lapām, kurā ir interesants saturs nav saites *ieteikt draugiem*, tad droši var izmantot šādu *bookmarklet* jeb javascript grāmatzīmi: [Pateikt draugiem!](javascript:(function()%7Bwindow.open('https://www.draugiem.lv/say/ext/add.php?title='+encodeURIComponent((document.getSelection%20?%20(document.getSelection().toString()!=''%20?%20document.getSelection()%20:%20document.title):(document.selection.createRange%20?%20(document.selection.createRange().text%20?%20document.selection.createRange().text%20:%20document.title):document.title)))+'&link='+encodeURIComponent(window.location)+(document.domain?'&titlePrefix='+document.domain.replace('www.',%20''):''),'','location=1,status=1,scrollbars=0,resizable=0,width=530,height=400');%7D)();) (lai saglabātu pārlūkā vienkārši var ievilkt saiti grāmatzīmju joslā).

Grāmatzīme darbojas pavisam vienkārši - ja lapā ir iezīmēts teksts, tad tas tiks izmantots kā ieraksta virsraksts (ja teksts nav iezīmēts, tad tiks izmantots lapas virsraksts, par saiti tiks paņemta pašlaik atvērtā lapa, bet lapas nosaukums saturēs lapas domēna vārdu bez *www.*.
